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NOTICE 


The information contained in this document is subject to 
change without notice. 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERTAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE. Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse- 
quential damages in connection with the furnishing, per~ 
formance or use of this material, 


Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard, 


This document contains proprietary information which is 
protected by copyright. All rights are reserved. No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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SAFETY SUMMARY 


SAFETY SUMMARY 


The following general snfety precautions must be observed during 
all phases of operation, service, and repair of this system. 
Failure to comply with these precautions or with specific 
warnings elsewhere in this manual violates safety standards of 
design, manufacture, and intended use of the system. 
Hewlett-Packard Company assumes no liability for the customer’s 
failure to comply with these requirements. 


GROUND THE SYSTEM. 


To minimize shock hazard, the system chassis and cabinet must be 
connected to an electrical ground. The system is equipped with a 
three-conductor ac power cable. The power cable must be plugged 
into an approved three-contact electrical outlet with a safety 
ground. The power jack and mating plug of the power cable meet 
International Electrotechnical Commission (IEC) safety standards. 


DO NOT OPERATE IN AN EXPLOSIVE ATMOSPHERE, 


Do not opernte the system in the presence of flammable gases or 
fumes. Operation of any electrical system in such an environment 
constitutes a definite safety hazard. 


KEEP AWAY FROM LIVE CIRCUITS, 


Operating personnel must not remove system covers. Component 
replacement and internal adjustments must be made by qualified 
maintenance personnel. Do not replace components with power 
cable connected. Under certain conditions, dangerous voltages 
may exist even with the power cable removed, To avoid injuries, 
Glways disconnect power and discharge circuits before touching 
them, 
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SAFETY SUMMARY 


DO NOT SERVICE OR ADJUST ALONE. 


Do not attempt internal service or adjustment unless another 
person, capable of rendering first aid and resuscitation, is 
present. 


DO NOT SUBSTITUTE PARTS OR MODIFY SYSTEM, 


Because of the danger of introducing additional hazards, do not 
install substitute parts or perform any unauthorized modification 
to the system, Refer the system to a Hewlett-Packard Sales and 
Service Office for service and repair to ensure that safety 
features are maintained. 


DANGEROUS PROCEDURE WARNINGS. 
Warnings, such as the example below, precede potentially 
dangerous precedures throughout this manual. Instructions 
contained in the warnings must be followed. 
WARNING 
Dangerous voltages, capable of causing injury, are 


present in this system. Use extreme caution when 
handling, testing, and adjusting. 
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DIAGNOSTIC/UTILITY SYSTEM 
{DUS ) 


EXTERNAL REFERENCE SPECIFICATION 


Program Revision: Q4.xx 


References: 


AID ERS CHandbook Section 44141 
Diagnostic and Test Program ERSs ({4xx, Sxx Handbook Sections] 


JUN &, 1980 440- fj. 


DIAGNOSTIC/UTILITY SYSTEM ERS 


OS0f OONE OEET DERE OEE GeND I8Ch E681 48R BEER BEEE COET ORE LONE GENE EOEE FEOF SOLE EFEE SEES OUST CECE DIED CODE CURE BEES GOEE SERS CREE TENE 260 FONE CONE CODE DOES SEET OOET DOES DETE CREE ENTE CREE FONE EIDE EDRE URE EOEE EF00 OOEE ZEEE SETE GEES DERE CEOE OFEE FEI GEES OREE Nee FeEE PELE GORE FOES CtEt BORE aeRe eNO ENte Bete Beee 


AOed GORE C4OW OO4E COEF 0600 S18 4H0e S104 HUIS HONE GEOG CONE FEEL LORE FEEG 4060 COEF OOEE HEDE OEE DOLE EEEE HALE OLE COEF LEED FO>PD BEET OOOE ODOT COLE HORE OEEE GOEL COOE 4440 4480 4OE0 EERE O00 C000 CEEE GEES SEES COTE GHEE SEE O04 BEET GHEE HORE CoOE Ene F4bt GOON wee CORE doED HEOY SEHE UOEe ONE 


em ee 


NOTICE 


The information contained in this document is subject to 
change without notice. 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR &A 
PARTICULAR PURPOSE. Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse~ 
quential damages in connection with the furnishing, per- 
formance or use of this material, 
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Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard, 
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This document contains proprietary information which is 
protected by copyright. All rights are reserved, No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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4.0 INTRODUCTION 


The Diaanostic/Utility System is a memory-resident means of 
running diagnostic and utility programs on the HP 300 and HP 
3000/33 systems. 


The Stand Alone File Manager (hereafter referred to as SAFM) is a 
disc~hbased software module forming the heart of the 
Diaqnostic/Utility System. 


In addition to the SAFM, the Dinqnostic/Utility System includes 
the AID (Advanced Interactive Diagnosis) interpreter together 
with a set of SPL-IT and AID programs and supporting files. 
Generally, those programs provided in support of the Operating 
System are classified as Utilities and programs whose primary 
function is to test hardware and firmware subsystems or 
peripherals are classified as Diagnostics. 


Independent of operating systems, the SAFM gives you access to 
files (lecated on a disc) and enables you to modify, delete, add 
or create these files. A disc-based directory allows interchange 
of file information with other discs, 

4.4 Required Hardware: 

HP 300 or HP 3006/33 consisting of: 

(4) Memory ~- 128K words mininum A 
(2) Conseole-~ HP 300: IDS or HP 264X/262X% terminal and ADCC board 
HP 3000/33: Consele or HP 264X terminal 

(Terminal is strapped and configured same as for 
operating system use. Terminal may be set for any 
buad rate ~- DUS uses ENQ/ACK tests to find the 
terminal’s baud rate.) 


(3) Dise ~ HP 7902 Flexible Disc Unit 


(4) Printer~ HP 2634 printer Coptional) 


1.2 Qverview 
The following diagram provides a picture of how the SAFM 


integrates with other program modules and the Diagnostic/Utility 
Systems 
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OPERATING INSTRUCTIONS 


Loading the System 


Loading DUS on an HP 300: 


(4) 


CS) 


(9) 


Bring any application programs and the operating system to an 
orderly halt. 


Insert a Dingnostic/Utility flexible disc in the Flexible 
Dise Unit. 


Set the Control Panel CHANNEL and DEVICE switches to the CHAN 
ADDR and DEVICE ADDR of the 7902 FDU, 


Press HALT, press SYSTEM RESET, then press LOAD. 
The Control Panel READY lamp will illuminate, 


SELECTED lamp will extinguish when the cold load is complete, 
RUN Light heartbeat: NIR LEDs show DUS program halt !35., 


Set the Control Panel CHANNEL and DEVICE switches to the CHAN 
ADDR and DEVICE ADDR of the System Console, (For a terminal 
on an ADCO, set the DEVICE switch to the port number of the 
terminal -~ terminal baud rate is determined automatically by 
DUS.) 


Press RUN, 
RUN Light on. The welcome message and prompt are displayed: 


Diaanostic/Utility System (revision XX.xXXxX) 
Enter your program name (Type HELP for program information) 


(The revision is determined by the latest release date of the 
DUS programs HELP is an AID program that presents file and 
command information.) 


If no device or bad device at address ~~ RUN Light heartbeat; 
NIR LEDs show DUS program halt !314. 


Loading DUS on an HP 3000/33: 


(4) 


440~ 


Perform an MPE *SHUTDOWN’? to properly logoff every current 
session, if applicable. 


Run the console Self-Test by pressing TEST on the keyboard 
and verify the displayed results (see 2645 User’s Manual), 
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(3) Turn PROCESSOR power OFF and then ON to place the system 
hardware in MICRO RUN and PROGRAM RUN, (The DUS system will 
not load if this step fails). The RUN light on the front 
panel should be lighted, 


(4) Fully reset the console by depressing the RESET TERMINAL key 
rapidly twice, 


(S$) Insure that the console is in REMOTE. CREMOTE key in 
depressed position.) 


(6) Insert a Diagnostic/Uti lity flexible disc into the 7962 
Flexible Disc Unit. 


(7) Set front panel COLD LOAD thumbwheels to the CHAN ADDR and 
DEVICE ADDR of the 7902 FDU, 


(8) Press HALT, then press LOAD, 
(9) The welcome message and prompt are displayed: 
Dingnostic/Utility System (revision XX.xXX) 


Enter your program name (Type HELP for program information) 
i 


(The revision is determined by the latest release date of the 
DUS program; HELP is an AID program that presents file and 
command information.) 


2.2 Console Control 


All user inputs are terminated with ENTER or carriage return/line 
feed on the console device, 


To interrupt program execution, press: 


~ ATIN if the console is an HP 300 IDS 
~ Control-Y if console is a terminal 


2.3 Running Programs 


To execute an AID or SL3OO/SLMS program file, enter the program 
name as follows: 
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Enter your program name (Type HELP for program information) . 

:PROGNAME (The program PROGNAME will now be loaded and executed) 

(Upon completion of the program the Diagnostic/Utility System 
returns to its entry mode) 


r 
i 


Enter your program name 
2.4 Using the File Manager 


If you wish to credte, modify, om inquire about files type 
"MANAGER", You will be prompted with: 

Stand Alone File Manager (revision XX.XX) 

Enter Command (LC for List Command) 

> ¢Any DUS command may now be executed) 


K Gee Security Code, paragraph 2.6, for further details. 


2.5 Using AID 

If you wish to create, modify, or make ad hoc changes to an AID 
programs you may do so by typing "AID". The resulting 
interaction is described in the ATID ERS. (CHandbook Section 4441 


Kk See Security Code, paragraph 2.6, for further details. 


2.6 Security Code 


The system and program security code is the ASCII value (not 
character) of one. This character is generated as follows: 


HP 300 IDS ~ any Soft Key or CNTL in unison with any numeric 
key 


2O4X ~ CNTL in unison with ’A? 
The security code is normally required to execute a file or 


command which allows file access (e.g. SAVE, PURGE) or alteration 
of a test sequence (Ci.e., the TEST command in AID). 
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3.0 FILE STRUCTURES AND FORMATS 


3.4 Filenames 


Filenames are restricted to eight alphanumeric ASCII characters 
starting with an alpha character. 


Valid Filenames Invalid Filenames 
TEST 4DIAG 
D44TEST TEST. 
ADCCDIAG »TEST 
133 AB/TEST 


Note ~ The filenames AID, DIREC, IDSBOOT and SCRATCH are 
reserved, 


3.2 File Types 


Internally, files are typed as follows: 


Type Description Created by 

AID AID program AID SAVE Command 

SL3O0 SL300 program DUS SAVE Command H 
DATA data file CREATE Command 

SLMS Multiple Code Seq- DUS SAVE Command 


ment SL300 program 


The AID, SL300, and SLMS types constitute the programs available 
to the user. The DATA files are transparent to the user but are 
used by development or accessed by some of the programs. 


3.5 File Classes 


File classes have no siqnificance to the Diagnostic/Utility 
System. They are provided for the support of software which reads 
the directory. AID and SL3OO/SLMS program files are classified 
according to the service they provide. There are two classes of 
program files: UTILITY (WU) and DIAGNOSTIC (D). 


Data files are classified by content: ASCII (A), BINARY (B), 
CPUCODEX (C), and MCCCODEX (MM). 


KX HP 300 only ~~ see IDS Diagnostic ERS [Handbook Section SS4B] 


At file creation time each AID program file is classified as a 
DIAGNOSTIC, each SL3OO/SLMS program file as a UTILITY and all 
DATA files as ASCII. The CLASSIFY Command may be employed to 
change the classification as required. 
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3.4 File Access 


The Stand Alone File Manager user may access any file on any 
Diagnostic/Utility Disc, 


~ Tf you have entered an AID program and cannot save it on disc 
because of lack of space, you may remove the currently 
installed Dingnostic/Utility Dise and insert another 
Diagnostic/Utility Disc and again attempt to save your program 
(this process is repeatable indefinitely). 


~ Similiarly if you need a file that doesn’t reside on the 
currently installed Dingnostic/Utility Disc, you can simply 
insert another Diagnostic/Utility Disc and determine whether 
or not the new disc contains the file you want, 


There are some restrictions when accessing certain types of 
files. Most of these restrictions will be pointed out throughout 
this document, however a few general rules apply: 


~ The directory file (DIREC) is a permanent file which can be 
read but can never be modified or deleted. 


~ The IDSBOOT file (see IDS Dingnostic ERS, Handbook Section 
55458) is a permanent file which can be read but can never be 
deleted. Because of the requirements of the HP 300 IDS 
microcode, IDSBOOT is handled in a special manner by DUS. A 
new version of IDSBOOT may be installed on a DUS disc via the 
SAVE command; however IDSBOOT may not be PURGE’d, RENAME ?d, 
CHANGE’d, or CLASSIFY?’d., 


~ Files which are protected must be unprotected before 
alteration, (See the CHANGE command, ) 


~ The SCRATCH file is a 60 sector scratch area usable by anyone 
for general temporary data storage, 


~ AS of DUS Version 04.04, the HP 300 DUP was given the 
capability to read and write files from/to an HP 3606/33 or HP 
5000/30 DUP diskette. This capability is intended to allow 
the exchange of AID programs and data files between HP 300 and 
HP 3000/33 etc.) systems, 


CAUTION 
Be careful not to try to exchange SL3OO/SLMS or SPL 


program files between HP 300 and HP 3000 systems! They 
are not cross-compnatible! 


Oe ee td 
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4.0 FILE COMMANDS 


The Stand Alone File Manager contains a command set that allows 
alteration of and access to files, The commands are explained in 
detail on the following pages. For convenience, some parameters 
gre optional; optional parameters are enclosed in brackets], The 
operator may input any valid command after the DUS prompts with: 


Enter Command (LC for List Commands) 
> 


Any error in syntax or errors which occur during command 
execution are identified by a message. Should difficulty arise 
understanding an error message refer to Error Messages, Section 
S$.2 of this document. 


4,4 CHANGE 
OPERATION NAME: Change file security 


MNEMONIC: CHANGE fllename TO ULNPROTECTED] 
CHANGE filename TO PLROTECTED] 


DESCRIPTION: Allows the operator to protect or unprotect a 
file. A protected file Indicates it is not 
PURGEable and is readonly. 


EXAMPLES: Enter Command (LC for List Commands) 
CHANGE DIAG4 TO P (changes the file DIAG4 to 
a non-PURGEable and read 
only file> 
Enter Command (LC for List Commands) 
>CHANGE DIAG4 TO U (change DIAG4 to a PURGEable 
read/write file) 
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4.2 CHANGETO 


OPERATION NAME: Change I/O device number 


MNEMONIC: CHANGEIO CONSOLE TO channel number, device number 
[DISC] 
[PRINTER] 

DESCRIPTION: Changes the defavit 1/0 device used by the DUS. 


The channel number is accepted as decimal in the 
range 0¢=channel number<=iS and the device 
number must be in the range O<=device number<=7, 
There must be a legal device at that location. A 
channel and device number equal to 0 implies 
that device is not available to the DUS. see 
LISTIO command. 


EXAMPLE: Enter Command (LC for List Commands) 
>LISTIO 
DEVICE TYPE CHANNEL DEVICE 
CONSOLE 3 0 
DISC 2 & 
PRINTER 2 3 


Enter Command (LC for List Commands) 
>CHANGETO PRINTER TO 3,4 (change printer to 

CHANNEL 3,DEVICE 4) 
Enter Command ‘(LC for List Commands) 


>LISTIO 

DEVICE TYPE CHANNEL. DEVICE 
CONSOLE 3 0 
DISC 2 & 
PRINTER 3 4 
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4,3 CLASSIFY 
OPERATION NAME: 
MNEMONIC : 


DESCRIPTION: 


EXAMPLE : 


K HP 300 only -- 


4.4 CREATE 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLE : 


Reclassify a file 
CLASSIFY filename AS class 


This Command has no siaqnificance to the 
BDiagnostic/ Utility System but provides support 
for software which accesses the directory. It 
fallows the user to reclassify the file filename 
to ma new class where 


class = ULTILITY] 
DE TAGNOSTIC] 
ACSCITI 
BCLINARY] 
CLCPUCODE1* 
MCCCCODE 1x 


Enter Command (LC for List Commands) 


>CLASSIFY DATA AS BH (changes the file DATA‘ 
to a BINARY classification) 


see IDS Diagnostic ERS EHandbook Section SSiB] 


Create a data file 


CREATE filename, number of sectors [,revision] 


Creates (i.e. adds to the directory of files) an 


ASCII data file named "filename" which will be 
“number of sectors" Long. The range on the 


number of sectors is i¢=sectors<(=310. If the 


optional revision is not added then the revision 
00.00 is used. (See LF Command for the format 
of revision), 


Enter Command (LC for List Commands) 

*CREATE TEST,4, 041.02 (creates an ASCIT data file 
TEST with a length of 4 
sectors and a revision of 
94.02) 
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4,5 EXIT 
OPERATION NAME: Leave file manager 


MNEMONIC: EXIT 

DESCRIPTION: Causes computer to leave the file manager and 
return to the Diagnostic/Utility System entry 
mode, 

EXAMPLE : Enter Command (LC for List Commands) 
EXIT 


Enter Your Program Name 


4.6 LC 
OPERATION NAME: List the file management commands 


MNEMONIC: Lc 
DESCRIPTION: Lists the File Manager Commands followed by a 
short description of what the conmand does. 
EXAMPLE: Enter Command (LC for List Commands) 
LC 
LF List the file directory 


° ry « . 
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4,7 LF 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLE : 


Stand Alone File 


Filename Type C1 


204d 1OFe CORP GREE MOCe G0E0 GHEE BONS ONE Gone Ott Gade GATE Ee BEET NOE 


TEST ATD 

DIAG $L.300 
ABC DATA 
DIAGL SLMS 


CYLINDERS USED=5 
The List he 
Filename 


Type 


Class 
P/U 


Length 


AID type 
SL300/SLMS type 


type 


Sec - 


DUS 


List the file directory 


LF f{PERINTERII 

Lists the file directory of the resident 
Diagnostic/Utility Disc which contains all 
pertinent information for the user. If the 
optional PRINTER is used the directory will be 
listed on the system printer device, 


Enter Command (LC for List Commands) 
>LE 


Directory 


ass P/U Lenath Cyl Hd Sec Revision Prog Data Stack 
U P 427 4 0 7 00.096 320 28123 4107 
D U 400 4 0 iif 00.006 300 100 200 
A U 12896 4 0 46 00.00 0 0 0 
D P 7590 4 0 26 00.60 400 350 600 
ader has the following meaning: 
the name of the file. 
the file type that filename is currently 
desiaqnated as (see File Types Section for 
explanation of type meanings). 
classification of the file. 
desiaqnates whether the file is Protected 

or Unprotected, . 
the length of the file in words. This length 
is calculated as follows: 
= size of the AID program before executionoan 
= size of the program (PL-PE) + size of the 

data area (DL-DEB). The stack (Z~SB) 

occupies no space in the file. 
= created size 
the physical disc cylinder address of the file. 
the physical disc head address of the file. 
the physical disc sector address of the file, 
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DUS - FILE COMMANDS 
Revision ~ a five-digit code with the following format: 


where 04 siqnifies the major revision level and 
02 signifies the minor revision level, 


Proa ~ this length in words is calculated as follows: 
AID type = program area (object code) of the AID program. 


tJ 
SL300/SLMS type = Program Limit-Program Base Register (PL=PB) 
DATA type = no significance, 


ee ae oe 


Data ~ this length in words is calculated as follows: 


AID type 
SL300/SLMS type 
DATA type 


buffer area available for the AID program, 
Data Limit-Data Base register (DL-DE). 
No siaqnificance., 


Hon il 


Stack -~ this length in words is calculated as follows: 


we 


AID type 
SL300/SLMS type 
DATA type 


{number of AID statements in the program x 2)+4, 
Stack Limit~-Stack Base register (Z-SB). 
No significance. 


HOMO 


The "CYLINDERS USED" message indicates the amount of cylinders 
agllocated by the system including the "holes" left by PURGE and 
SAVE. . 
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4.3 LISTIO 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLE : 


4.9 LOAD 
OPERATION NAME: 
MNEMONMIC : 


DESCRIPTION: 


4.40 PACK 
OPERATION NAME: 
MNEMONIC : 


DESCRIPTION: 


List the System 1/0 
LISTIO 


Lists the current I/0 configuration of the 
System Console, System Dise and System Line 
Printer. This configuration may be modified by 
hardware (changing a device’s device number?) or 
by software (see the CHANGEIO command). A 
channel and device number equal to 0 imples that 
device is not available to the DUS. 


See CHANGETO command example. 


Load file into memory 


LOAD filename 


Loads a file into the memory, This command would 
typically be used for modifying a file Ci.e, 
LOAD, modify memory, SAVE) or for transferring a 
file from one disc to to another (i.e. LOAD, 
Switch discs, SAVE). 


Pack files 


PACK 


The dise is never packed until this command is 
executed so "holes" may develop in the file 


structure as a result of the PURGE and SAVE 
commands. To remove these "holes" a PACK should 


the files on the disc will 
be contiguous. Note however, an unpacked digc 
presents no problem until a file cannot be 
stored because of no room left on the disc, 


be executed so that 
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DUS ~ FILE 
4.44 PURGE 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLE 
4.42 RENAME 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLE : 


4.43 SAVE 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLE : 
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Purge File 
PURGE filename 


Allows the operator to remove a file from the 
disc. ALL files may be purged except protected 
files. If a protected file must be purged the 
operator must change the file to unprotected and 
then purge it (See CHANGE command). 


Enter Command (LC for List Commands) 
XPURGE DIAG 


Rename File 

RENAME old name , new mame 

Allows the operator to change the name of a 
file. No other characteristic of the file is 


changed. 


Enter Command (LO for List Commands) 
RENAME DIAGL, DIAG4S4 (DIAG becomes DIAG44 i.e. 
DIAGi no longer exists). 


Save a file by storing it on dise 
SAVE Filename [,revision] 


Stores the AID, SL3GO/SLMS or DATA file that is 
currently in memory onto the System disc, This 
command would typically be used for modifying a 
file (i.e, LOAD, modify memory, SAVE) or 
transferring a file to another dise ¢Ci,e, LOAD, 
gwitch discs, SAVE), If the optional revision is 
not added the current revision of the file is 
used (See LF Command for revision format). 


Enter Command (LO for List Commands) 
SAVE DIAG. 01.02 
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5.0 ERROR INTERPRETATION 


5.1 Firmware Traps 


If the machine firmware detects a condition that takes control 
from the executing user program Ce.q. Bounds Violation, Stack 
Overflow) because of either a software or hardware problem, the 
following message is printed on the System Console: 


Example: KXSYSTEM FATLUREXK 
While executing FILENAME 
relta P=l34i Code Seqnent=!3 i 
Stack Overflow 


Delta P equals the hex offset from PRtO, Code seqment equals the i 
code gegnent that was executing when the failure occurred and 

Finally, oa deseriptive megeage indicating the mature of the 

failure Ci,e, Stack Overflow in this exaenied, The system is 

halted and if RUN is pressed an attespt to recover back to the 
Diagnostic/Utility System entry mode i868 made, 


S.2 Error Messages 


Message Meaning 

Invalid Filename The filename porameter did not meet the 
requirements of a valid filename (See 
Filenames, Section 3.4 of this document.) 


Disc Failure!! Did The system disc didn’t complete a seek, 

not respond within read or write within a reasonable tine 

i0 seconds (approximately 410 secd, Possible 
hardware failure, 


Printer Failure!! Did A line printer output was requested but 

net respond within the line printer did not complete its 

40 seconds operation in normal time (approximately 
40 seconds). Check for printer on-line, 
printer device correct and printer 
attached to HP~IB correctly. 


JUN 6, 1980 440- 19 


DUS ~- ERROR INTERPRETATION 


e908 S60F: 2008 Due OOFE OARS OEUD Cone Orme DEED FONE-OOEE SHEE BOEd 4100 UE) SOOT BEES GEES HEOd SEES BEDE EES EELS bese BEE4 ODED OEE SEED DEEe HEEY HOVE BOND Cede COON DURE Foe LeEd HOFF GEES BOED OHNE OPEY SOEs OND EPEE FED ONEs HERD BEET GOES SEEE OEE Fone Stns EEEE FORO Gene Send SEDe COED SOLE GEES SEES SeEs Ete Bebe DEED Coss Beee 


Disc error on Directory 
write! Dise is 
probably mo longer 
usable! 


File Directory Full 


Insufficient Disc Space 


File access violation 


File system 
unaltered 


No such file 
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While writing an updated directory onto 
the disc a disc write and subsequent 
retry failed. The directory may be in 
one of the following states: 


4) invalid data was written meaning the 
Diagnostic’ Utility BDise File system 
is no longer usable, 


Po 
~~ 


no write actually occurred meaning 
the Diangnostic/Utility Disc is intact 
with the last file operation 
disregarded, 


3) enough data was written before the 
error occurred meaning the 
Diagnostic/ Utility Dise would be 
intact with the last file store 
operation successful. 


In any case try a new cold-load and LF 
Command to ascertain the condition of 
the Dinqnostic/Utility Disc. 


The current disc operation would exceed 
the 58 filename directory entries limit. 


Alternatives include PURGEIng a file or 


using another disc, 


There’s no disc space available for this 
file, Alternatives include inserting «a 
different Diaqnostic/Utility Disc and 
retrying the store operation or 
executing the PACK Command and then 
retrying the store operation, 


This error occurs when a file access is 
attempted on’a file or file type that 
isn’t compatible with the command or 
operation, Ce.g. RENAME oldfile .newfile 
where newfile exists already). Also 
occurs when an attempt is made to alter 
the files DIREC or IDSEOOT. 


Can occur during a command such as SAVE, 
A recoverable disc error occurred with 
no alteration of the directory. Retries 
of the last operation may be attempted, 


Indicates that the specified file 


doesn’t exist in the resident 


Diagnostic/ Utility Digse Directory, 
Check for misspelling or try another 
Dingnostic/ Utility Bise. 
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Not a Diagnostic/ 
Utility Disc 


Invalid Command 
or Input 


Abort! ! System not 
usable 


KXSYSTEM FATLUREXX 


No File in memory 


File Protected 


Pack Aborted!! 


Invatid Revision 


SEEK /READ/WRITE 
FATLURE! ! 


Disc is Write Protected 
or mot in the drive, 


Not a Printer device 


Indicates an attempt was made to store a 
file onto a disc other than a 
Diagqnostic/Utility Disc. 


The command requested or parameters 
following it do not conform ta the 
required command structure, Execute an 
LC command or refer to the command 
description to ascertain the correct 
Format, 


The last operation resulted in an 
irrecoverable error, Verify correctness 
of the last operation, Cold load to 
attempt restart. 


See Firmware Traps, Section S,.4 of this 
document. 


& SAVE Command was attempted when ro 
valid file is resident in memory, See 
LOAD command. 


An attempt was made to PURGE a file 
which has been designated protected, See 
CHANGE Command for changing protected 
status, 


Aan irrecoverable disc error occurred 
during the PACK Command, 


The revision input did not meet the 
syntax requirement, Gee LF Command for 
the expected format, 


A disc error occurred while accessing 
the the system disc. This message will 
be preceded by a message indicating the 
two word status (in hex) returned by the 
disc as follows: 


SEEK/READ/WRITE STATUS=!1XXXX !XXXX 


A disc access was attempted when a 
diskette was not in the drive. Algo, a 
a disc write attempt to a write 
protected disc will produce this 
ARSSAQS . 


A CHANGETO command attempted to 


desianate a device which doesn’t 
identify as a supportable printer. 
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Not an HP 7902 Disc & CHANGEIO command attempted to 
designate a device which doesn’t 


identify as a HP 7902 Disc. 
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SECTION 441A 


AID LANGUAGE 


EXTERNAL REFERENCE SPECIFICATION 


Proqgram Revision: 04.Xx 


References: 


DUS Summary {Handbook Section 1403 
DUS ERS CHandbock Section 440] 
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The information contained in this document is subject to 
change without notice. 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. FOR A 
PARTICULAR PURPOSE, Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse- 
quential damages in connection with the furnishing, per- 
formance or use of this material, 


Hewlett-Packard assunes mo responsibility for the vse or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard. 


This document contains proprietary information which is 
protected by copyright. All rights are reserved. No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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LC 
L.F 
LISt 
LOAD 
L.OOP 
L.OOPOFF 
MODIFY 
PURGE 
REN 
RST 
RUN 
SAVE 
SEPR 
SEPS 
SET 
SNPR 
SNPS 
$0 
TEST 


list commands 

list files 

list statements or data 
load AID program 

set loop flag 

clear loop flag 

modify statement 

purge file 

renumber program 

reset control flags 
execute program 

save AID program 

suppress error print 
suppress error pause 

new statement number 
suppress nén-error print 
suppress non-error pauses 
shut off streaming 
specify test section to execute 


AID Statements (Non 1/0) 


ASSIGN 


EPAUSE 
EPRINT 
FTLENAME 


FOR-STEP-UNTIL 


GOSUB 
GOTO 

TF ~THEN 
TFN~THEN 
INPUT 
INPUTE 
LET 

LOOP TO 


, LPOFF/L.PON 


NEXT 
NOCHECKS 
PAGE 


> PAUSE 


PPRINT 
PRINT 
PRINTEX 
RANDOM 
READCLOCK 
READFILE 


» RETURN 


SECTION 


4 


store data buffer 

increment pass counter 
compare buffers 

comment entry 

define buffer 

suspend execution 

allow error reporting 

cease execution 

error pause 

error print and pause 

declare user file | 

start FOR-NEXT sequence 

go to subroutine 

branch to statement 
conditional branch to statement 
conditional branch to statement 
get operator input 

get operator input 

assignment 

conditional loop branch 
control print to line printer. 
end of FOR~NEXT sequence 
Suppress error checking 

page to line printer 
non~-error pause 

non-error print and pause 
non-error print 

error print 

get random number 

read system clock count 

read data from file 

return from subroutine call 
test section execution decision 
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SPACE space one line to line printer 
SPACESOFF/SPACESON control leading spaces print 
STARTCLOCK initiate system clock 
SUPPRESS stop error reporting 

WRITEF ILE write data to file 


ZERQESOFF/ZEROESON control leading zeroes print 


Special Characters 
» Comment) 
CONTROL H 
CONTROL X 
PARENTHESES 
| 
ys 
PRINT SPACING 
> 
& CAmpersand) 


, 
CONTROL Y CATTENTION) 


3.2 or 27 


» Comma) 
/(Slagh) 
CTRL-Shift CHold up listing) 


Operators 


C or 8 or > or >= 


MOD 

LSL or LSR 

ASL or ASR 

CSL or CSR 

Special Relational Operators (NE, ESQ, LT, GT, LE, GE) 


Reserved Variables 


BADINTP illegal interrupt information 
CHANNEL. device channel under test 
CONCHAN Console channel device 

DEVICE device number under test 
FILEINFO file information 

FILELEN length of file 

GOP AR AMn GO Command parameters 

INDEX CER statement result 

TINPUTLEN last character length input 


AID ERS 


610 0-08 O6R0 4008 GME Deds EVES BUS Ob PETE OLED CEDE SEND GEES OEE CRED HOO OWE ESS BERD SEED OME HERD DIE S600 CADE OE0E DEE O6DE OOF Sed O60 ind SOLE OS 41S BME SHED LEE OOO CED ORFS CIEE OED ETE FOO SHOE GIDE HOF 0 ES FROO DED ENDO FIDE FPO Owe OID O10 OME 6 BONS SHE OD Od GIDE ONO One o> 1 Bite MOE 


441i A~ 


S 


AID ERS 


HOO COD 0910 Bbw SEED COUR EOED COLD OLH? FIT OAOE CODE C419 SIDE UDRP SES BEC CNS SOIT ONS OOTD CEdE SebD Sed GENT SO60 DELS OUED SEDO OHS BUS OF HOT 06S SOD SEED CHO CONS COED CENT OTD CEES 9UES OEE Om SOEs BEN HEL GEES BED ES FES-ONE Ome POEL 4 ODE ODE C100 OUD SOOP LEPE-UEOE OOTF OED) OADE SRE Ome cnED. REEe 


7.40 MAXMEMORY memory space available 

7.44 NEWTEST TEST Command indicator 

7.42 NOINPUT non-error print indicator 

7.43 NORESPONS I/O operation condition cade infe 

7.14 OFFSET control RETURN point 

7.435 PASSCOUNT proaqras pass counter 

7.16 RUNPARAMN RUN Command paraneters 

7.47 SECTION currently executing Test Section 

7,48 SECTIONSn Test Section indicators 

7.49 STATENUM last executed FUNCTION~-calling statementi 
7.20 STEP currently axecuting Step H 
7.e4 TIMEQUT I/O timeout control H 
7,.@@ TRUE or FALSE ~4 for TRUE, 0 for FALSE H 
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8.2 &SIo define Channel program 

8.3 COPY duplicate Channel program 

8,4 CPVA define CPVA buffer 

8.5 ESTO end Channel program definition 

8.6 HIOP halt Channel program execution 

8,7 INIT initialize I/0 Channel 

8.8 TOch clear all I/0 Channels 

8.9 ION/IOFF control interrupt system 

8.40 LOCATE find Channel proaram instruction 
8.44 PROC control I/0 with/without wait 

8.42 RDRT read DRT word 

8.413 RIOC read I[/0 Channel 

8.44 RMSK  pead interrupt mask info 

8.415 ROCL roll call I/0 Channels 

9.44 RSIO run Channel program 

8.47 RSW read Switch Reqister 

8.48 SMSK . set interrupt mask 

8.49 UPDATEQN/UPDATEOFF control bit S word 4 of Read/Write 
8.20 WIO0C write I/G Channel 
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9.4 CHP command HP-~Ik 

9.2 CLEAR clear I/0 Channel 

9.3 DST device specified jump 
9.4 IDENT identify device 

9.5 IN interrupt halt/run 
9.& JUMP Channel program branch 
9,7 RB read burst 

9.8 RDMAKB read burst with DMA 
9.9 RDMAR read record with DMA 
9,40 RMW read-modify-write 

9.44 RR read record 

9.42 RREG read register 

9.43 WALT suspend for device service request 
9,44 WE write burst 

9.45 WDMAR write burst with DMA 
9.46 WDMAR write record with DMA 
9.147. WR write record 
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9.48 WREG write I/0 Channel register H 
9.49 WRIM write immediate 
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ig.2 GETNAMEDATA read name parameter data 
10.3 GETNAMEINFO Get name parameter identity 
information 
10.4 FUNCTION beqin Function definition 
196.5 SETNAMEDATA Store data into name parameter 
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4.0 INTRODUCTION TO AID 


AID (Advanced Interactive Diagnosis) is a stand alone proaqranm, 
independent of operating systems, which interprets operator 
statements and commands with emphasis on easy communication with 

I/O devices. HP AID is designed for use on an HP 300 or HP 

3000/33 System containing at least 256K bytes of memory with a H 
device to load AID and a keyboard console for operator 

interaction. 


HP AID consists of statements for writing programs and commands 
for controlling program operation. It is the intent of HP AID to 
provide the operator with the ability to communicate with many 
different 1/0 devices in an interpretive level language while 
maintaining execution efficiency as if the program was written in 
a lower level language. 


This ERS assumes the operator is familiar with the keyboard 
Console and terms related to the console (e.g. ENTER). 


For documentation purposes, throughout this ERS, characters 
output by the computer are underlined to distinaquish them from 
user input. 


All references to ENTER will be considered synonymous with 
similar keys or controls on other consoles or specialized 
consoles (i.e. the ENTER key on the IDS performs the same 
function as return/line feed on most consoles). 


This ERS makes reference to the Dingnostic/Utility System which 
is documented in the Diagnostic/Utility System ERS {Section 440]. 


1.4 Special Keys 


RETURN Must be pressed after every 
or command and statement. It 
ENTER terminates the line and causes 


the Console to return to the 
first print position. 


linefeed Advances the Console one line. 


CTRL When pressed simultaneously with 
another key, converts that key to 
a control character that is 
usually non-printing,. 


CTRL H (Bs) or BACKSPACE Deletes the previous character in 


& line. The cursor is moved one 
space to the left, 
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CTRL X (Cnd or DELETE ENTRY Cancels the line currently being 
typed. Three exclamation marks, a 
Return and Linefeed are issued to 
the Console (Note~ May not apply 
to all Console types), 


CTRL Y (Em) Suspends AID program execution, 
or reports the statement number 
ATTENTION currently executing and prompts 


(>). See the PAUSE command for 
further action. CTRL Y has no 
significance in the entry mode 
except during LISTing where it 
causes the LISTing to terminate. 


1.2 Prompt Characters 


AID uses a set of prompting characters to signal to the user that 
certain input is expected or that certain actions are completed: 


> The prompt character for AID; an AID command or 
statement is expected, 


? User input is expected during execution of an 
INPUTCB) statement, 


2? Further input is expected during execution of an 
INPUT statement. 


Pid A full line has been deleted with CTRL X (Note- May 
not apply to all Console types). 


4.3 Running AID 
To run AID: 


(4) Bring up the Diagnostic/Utility System (DUS) froma 
Diagnostic/Utility Disc. 


(2) Enter security code, then “AID? : 


(3) ATD will display its message and prompt. 
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4.4 AID Commands and Statements CIntroduction) 


4.4.4 Commands ~- AID Commands instruct AID to perform certain 
contrel functions. Commands differ from the statements used to 
write a program in that a Command instructs AID to perform some 
action immediately, while a statement is an instruction to 
perform an action only when the program is executed. A statement 
is always assigned a statement number; a command is not. 


Commands are entered following the prompt character (>). Most 
commands are allowed in either the entry mode or pause mode but 
net both. Each command is a single word that must be typed in its 
entirety with no embedded blanks. Some commands hove additional 
parameters to further define command operation. ; 


For a complete decription of all Commands, see Section 3.0 - AID 
Commands. 


4.4.2 Statements ~ Statements are used to write an AID program 
that will subsequently be executed. Each statement entered is 
Limited to 80 characters and becomes part of the current program 
which is kept until explicitly deleted. 


A statement is always preceded by a statement number. This 
number may be an integer between i and 9999 inclusive. The 
statement number indicates the order in which the statements will 
be executed. Statements are ordered by AID from the lowest to 
the highest statement number. Since this order is maintained by 
AID, it is not necessary for the user to enter statements in 
execution order. 


Following each statement, ENTER must be pressed to inform AID 
that the statement is complete. AID generates a return-line 
feed, prints the prompt character (>) and next statement number 
on the next line to signal that the statement was accepted. If 
an error was made in the statement, AID will print an error 
message prior to prompting (see Error Reporting). 


AID statements have a semi-free format. This means that some 
blanks are ignored. Imbedded blanks are not allowed in the 


keywords or variables, and keywords and variables must be 
separated by at least one blank. 
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> 30 PRINT S$ VALID 
> 30 PRINT S VALID 
> 30 PRINTS NOT VALID 
> 30 PRINTS NOT VALID 
> 30 PRINT S VALID 


For a complete description of all statements, see Sections 4, 8, 
9 and £0 - AID Statements. 


4.4.3 Changing or Deleting a Statement - If an error is made 
before ENTER is pressed, the error can be corrected with CTRL H 
CHe) or the line may be cancelled with CRTL X (Xc) (see Special 
Keys). After ENTER is pressed, the error can be corrected by 
replacing modifying or deleting the statement. 


To replace a statement, simply type the statement number followed 
by the correct statement, 


To replace this statement: > 30 PRINT X 


aoe ones e008 Sees 


retype it as: > 40 30 PRINT S 


e000 cone ceee etee 


or better yet, the MODIFY command may be used: 


> 30 PRINT X 


eene coey sees tone 


> 40 M30 


wees Coes veee enn 


30 PRINT X 


cone C000 cae ence Seen sone need 00S Sous COTE 


RS 
30 PRINT $& 


G00e 2000 cone been e008 S008 ene Soe vote BNee 


Center) 
> 40 (statement 30 is now PRINT S$) 


cone 2000 ever cose 


To delete a statement use the following format: 


Statement 30 is deleted by: > 400 DELETE 30 


cece wove cone sone eves 
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4.5 Programming 
Any statement or group of statements constitutes a program, 
This is an example of a program with only one statement. 


> 400 PRINT "HELLO" 


ante coed wane cone ange 


100 is the statement number. PRINT is the key word or 
instruction that tells AID the kind of action to perform, In 
this case, it prints the string that follows. 


The statement 100 PRINT "HELLO" is a complete program since it 
can run with no other statements and produce a result. However, 
4 program usually contains more than one statement. 


These three statements constitute a program: 


> 40 INPUT A,B,C,D,E 


e9ne 0000 eng0 cone 


> 20 LET S:*A+B+C+D+E/S 


epee O09 acer core 


> 30 PRINT S 


come oes cone ope 


This program, which calculates the average of five numbers, is 
shown in the order of its execution. It could be entered in any 
order if the statemant numbers assigned to each statement were 
net changed. 


This program input would execute exactly like the program above: 


> 40 20 LET S:sA+B+C+D+E/S 


> 30 40 INPUT A,B,C,D,E 


oeme ees que gree 


> 30 PRINT S 


ote wane epee oer 


4.6 Listing a Program 


The LIST command can be used to produce a listing of the 
statements that have been accepted by AID: 
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> 40 LIST 
40 INPUT A,B,C,D,E 


eens GARe STEP CER BEDE CREE CURE Fone BEET CONF SELE BEET ShER LEE BEEP CRUD HEED BEDI C000 
€00 0000 OEUD COED S000 ORED HOC SIDE 9E00 COR GORD BOOT REMY SeEe HEED HEED CObT HERE SONY DEED Gene HEtY 


ene C000 eEEE 9000 Gere SEES Geee GOED NONE Cone S000 


Note that the prompt character (>) is not printed in the listing, 
but is printed when the list is complete to signal that AID is 
ready for the next command or statement, 

Any LIST may be terminated with CTRL Y or ATTENTION, 

Refer to the LIST Command (Section 3.0) for other listing 
functions. 


1.7 Running a Program 


After a program is entered it can be executed with the RUN 
command. RUN will be illustrated with two sample programs, 


The first program contains one statement: 


> 40 PRINT "HELLO" 


quer ween ence sone 


When executed, the string HELLO is printed: 


OPRS Cae COUR ORE FOOD BOSE COED COS CECE SEEE SEEY CDOS BEDE COE COED SEE BEDE HOES BEDE SeEL RODE F9HP sete 


When the present AID program is done executing AID reports with 
“END OF AID USER PROGRAM" before prompting in the entry mode. 


The second sample program averages a group of five numbers. The 
numbers must be input by the user: 
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> 140 INPUT 4€,B,C,D,E 
> 20 LET S:=A+B+C+D+E/5 
> 30 PRINT S 


Each of the letters following the word INPUT, and separated by 
commas, names a variable that will contain a valve input by the 
user from the Console. When the program is run, AID signals that 
an input is expected by printing a question mark. The user 
enters the values, separated by commas, after the question mark. 


EXAMPLE: > 40 RUN 


? 7,5,6,8,9 


AID prints the result: 7 


END OF ATD USER PROGRAM 


2000 29be SEH ened CO0H Spee COED UEEE BPEE HOED ORS GPOE BOUT BEY COTE SORE SEEF NOSE SEbT OTRD F900 2000 Seen 


See the RUN Command (Section 3.0) for further details. 


4.8 Deleting a Program 


The program that has been entered may be deleted with the EP 
(Erase Program) command. 


On the previous page, the first program entered was 10 PRINT 
"HELLO", After it has run, it should be erased before entering 
the next program, otherwise both programs will run, as one, when 
RUN is commanded (i.e. they will run in the order of their 
statement numbers). 
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> 40 PRINT "HELLO" 

> 20 INPUT A,B,C,D,E 

>» 30 LET A: =A+K+C+D+E/S 
> 40 PRINT S 

> SO RUN 

2 7,5,6,8,9 

7 


END OF AID USER PROGRAM 
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the following sequence should be 


> 40 PRINT “HELLO" 


etee cone enve sone 


> 20 RUN 


S080 scnp cee tee 


HELLO 


eeen esse Ones sone 


END OF AID USER PROGRAM 


Aq0e Ace 2808 S0Oe COOD Case SAPS ODE TOTD SEES SOEs SOUP SETS CRED SHEE CONE BEES One FOE CREE COOP O19 Sere 


> 20 EP 


Confirm you want to ERASE the 


6000 S00 One S108 E06m sees S8e HOES ONES Sete Bate ante Keen Sees Stee OEEE EES Saee Oren MOTE TERT OmDe BOGS SED COte 


eves cone ener See cate sone ones Soun S060 wees Gene Snes DEES Cane 
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The user’s resident program area is now cleared and another 


program can be entered: 


> 40 


oar) mane pai cone 


> 20 
> 30 


> 40 


c098 ater cone eene 


INPUT A,B,C,D,E 
LET Si "AtB+C+D+E/5 
PRINT $ 

RUN 


2 45,25,32,44,27 


22 


ene eee 


END OF AID USER PROGRAM 


AOS 90s CRD BORE OOF GOOF OOEP HORE HOE CEE COE COED HOOD OFEE SOOE CREE BOEe BEES 


Unless this program is to be executed again, it can now be erased 


and another program entered, 
for further details, 


4.9 PDocumenting a Program 


See the EP Command (Section 3.0) 


Comments can be inserted in a program with the period(.) Special 
Character. Any comment typed after a period will be printed in 
the program listing but will not affect program execution, 
Comments cannot be continued on the next line, but as many 
comments can be entered as are needed, 


The previous sample program to average S numbers can be 
documented with several comments: 
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> 40 


>» 40 


eos pone ence cooe 


> 40 


> 40 


S. THIS PROGRAM AVERAGES 


7. & NUMBERS 


40 INPUT €,B,C,D,E .GET THE VALUES 


25.9 CONTAINS THE AVERAGE. 
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The statement numbers determine the position of the comments 
within the existing program. A list will show them in order: 


> 40 LIST 


5S . THIS PROGRAM AVERAGES 


POE CORT S000 CURE OFRE PERE CORD SEED CONE NEED COO ERED OHOT SPE SURE HOE GeER bene MEED G08 FETE CDOS GnDe DERE CEMS “ERD 


List of sample program 10 INPUT A,B,C,D,E GET THE VALUES 
EMCLOGING COMMER TE) 8 ete termite iieete er memten ene rin erence Het ne mim meer wii 
20 LET S:=A+K+C+D+E/5 


25 .S CONTAINS THE AVERAGE 


C0we CORE SORE OURS GELS SECT CORE BEET CES BOTT EES CEES CORD SESE CED SORE SOLE Gere FTE OTES ENDS SbEE CELE BEET ter CURD CUED Cote 


When executed, the program will execute exactly as it did before 
the comments were entered. See the comment statement (SECTION 
4.0) or the period (.) Special Character (SECTION 5.0) for 
further details. 


APR 10, 1979 44iA~ 


enae ones epee 


4,7 


INTRODUCTION TO AID 


AEAe S080 AOUb CGD HOOD REOT BOER OOD SEE Cod TEE UTR DORE CODE EOE FONE YORE GUED FUSE S00E CONS CORE BORD GORE SEED OOUD ENED SOE SEED SEDO SEED OOED REND HEED OTOD FEED CODE SEDE SOLO OPED ONES SOLE CODE EDES EOEE SEED SEES SEED CNRS SERS FEED DIED HELD SEES BOLE ODER FEDE SOND DTS CEES BEET CEES ERED SEbs SOOT OEEE SODP DDtE C9E0 RENE 


4.140 AID Operator Mode State Diagram 


Start H 

y ' 

: : LIST 3[ H H 
: Entry Mode foot or a oe ee >i Listing $ H 
: »40 8 (ee a ee ee H ; H 
' : done H H 
so sete cme sre st ene esa i 

H ° - done |t “ H 

~ + RUN i End of Program i EXIT ; i H 
{| Command i or Fatal Error i Command H i LISt H 

v H H Y) H H 

i; Execution Mode i Control-Y or : : H 
H H saves chet : ! H 
H fA om oe er es ee en ean tes en te ‘ : H 
H H : Pause : i 
i : PAUSE-type : Mode : i 
H i Statement : : i 
H Bae eee eee Pee 4 : ' 
H : GO Command > : | 
i iC Sie ee ee eee i : i 
H t RUN Command =: : i 
i bor eve cot ee soe re eve enn ev ene sre se sve : : H 
i H : : 1 
i Input . : 

: Statement ; H 

i i ENTER or H 

mY) i RETURN H 


6 e $ @ ¢€ #@ &¢ &£ # £ &£ © 8 & 8 & € SC 8 


: 7 } H 
Figure 4.4 -- AID Operator Mode State Diagram H 
=p ‘ 
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2.0 ESSENTIALS OF AID 


This section will explain some of the ground rules for handling 
constants, variables and strings. Also included are sections 
covering the basic elements of the Operators and Reserved 
Variables. For more precise definitions of the items covered, 
refer to the sections covering Special Characters, Operators, and 
Reserved Variables. 


2.4 Expressions 


An expression combines constants and variables with operators in 
an ordered sequence. Constants and variables represent integer 
values and operators tell the computer the type of operation to 
perform on those integer values. 


Some examples of expressions are: 
P+ %S / 27 P is a variable with an assigned value, 
S and 27 are decimal constants. The 


Slash (/) is the divide operator, 


If P = 49, the expression will result 
in the value 2. 


N-R+5- T N, R, and T centain assigned values. 
If N= 20, R = 10, and T = S, the 
value of the expression will be 10. 


There is no operator hierarchy and evaluation of expressions is 
executed from left to right. 


2.2 Constants 
A constant is either a numeric or a byte. 
Numeric Constants: A numeric constant is a positive or negative 


integer including zero. It may be written in any of the 
following three forms: 


*As a decimal integer ~ a series of digits with no decimal H 
point. H 
KAS an octal integer -~ a series of digits (but not 8 or 9) 


preceded by a percent (%) symbol. 


KAs a hexadecimal integer - a series of digits or letters (A - F 


only) preceded by an exclamation 
mark ¢!), 
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Examples of Decimal Integers: 
(Range is 0 ¢= INTEGER <= 65536) 

~41472 Cunary negate operation) 
+6732 (er 6732) 
0 
i97 
6S536 (or —1) 

Examples of Octal Integers: 


(Range is 0 <= INTEGER (= 44177777) 


~Z20 (OR % 177760) 
Examples of Hexadecimal Integers: 


(Range is 0 <= INTEGER <= !FFFF) 


IF 

123 

1A (NOTE: A represents the valve 10, not the i 
variable A) (or !FFEA) i 

“116 1 


Example of a byte constant: 


a» or ug or wye 


2.5 Variables 


A variable is a name to which a valve is assigned. This value 
may be changed during program executionk. A reference to the 
variable acts as a reference to its current value. Variables are 
represented by a single letter from A to Z, 


A variable always contains a numeric value that is represented in 
the computer by a 16-bit word. 


Variables may be manipulated as decimal, octal, or hexadecimal, 
However, variable type designations (i.e. ! or Z%) would be used in 
input and output ¢Ce.g. INPUT, PRINT) operations only. 


A decinal variable is identified by the absence of a % or ! 
preceding it: 


G, +6, and -G are decimal variables, 
2G or !G are not decimal variables. 
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An octal variable is identified by a preceding percent (4) 
symbol: 


4A and “4B are octal variables, 


A hexadecimal variable is identified by a preceding exclamation 
C!) mark: 


1K, !'G, !Z are hexadecimal variables. 


K All variables are set to zero when a LOAD or RUN command is 
entered. 


2.4 Data Buffers 


Data Buffers are identified by duplicate letters (AA - ZZ) and 
are manipulated as one dimensional INTEGER arrays with the ié-bit 
integer row valve defined within parentheses. This row value 
starts at 0 and may be represented by a variable A through Z, any 
Reserved Variable and constants only. Examples of Data Buffer 
elements! 


AAC4), CO(400), DD(G), SSCINDEX) 


Data Buffers may be declared up to the user memory available (see 
MAXMEMORY Reserved Variable). 


Once a buffer is declared with a DE statemantk it may be 
manipulated as a variable in the form of a decimal, octal or 
hexadecimal integerxx: 


AA C2) is a decimal buffer element. 
4BB( 200) is an octal buffer element. 
IFF C4) is a hexadecimal buffer element. 


Kk If a buffer is not initialized with data the content of any 
element is indeterminate. 


¥XThe octal or hexadecimal notation would be used only in INPUT 
and PRINT type statements. 
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2.5 Strings and String Buffers 


2.5.4 Strings ~ STRINGS are defined as any number of ASCII 
characters enclosed by quotation marks (i.e."“strings"). Any 
ASCII character (except the quotation mark) is allowed within the 
string. 


2.5.2 String Buffers - STRING BUFFERS are byte~oriented 
one-dimensional arrays used to manipulate STRINGS. These buffers 
are identified by duplicate letters (AA to ZZ) preceded by an 
ampersand (4) and are limited to the available user memory (see 
MAXMEMORY Reserved Variable). The element of a buffer is 
enclosed in parentheses and defines the byte to be manipulated. 
This element may be represented by a variable A through Z, a 
Reserved Variable or constant only. Examples of STRING BUFFER 
elements are} 


AACS > identifies byte 6 of buffer &AA Cindex 0 is the 
first element) 

&CC(20) identifies byte 24 of buffer &CC 

&GG(X) identifies byte X of the buffer 4&G6G 


Bytes are packed left-justified so that word one of a buffer 
contains: 


{20 0008 C000 CONS GANS S000 CBOE SETE 08R CONE COTS SEE GUDE SEET COED EOED EEE SURE DUTP SUNO OEND ene Oe 


w 
< 
-— 
m 
o 
3 
-¢ 
om 
{Tj 
ws 


STRINGS within STRING BUFFERS may be altered by using starting 
and ending byte indicators: 


&AACSTARTING BYTE, ENDING BYTE) 
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The following examples will display some of the rules in 
manipulating STRING BUFFERS: 


> 40 PRINT &AACLO) “PRINT BYTE 40 OF THE &AA BUFFER 


> 20 PRINT &AAC10, 20) /PRINT BYTES £10 THROUGH 20 OF &AA 


> 25 ANY EXPRESSION RESULT MAY BE STORED INTO A BYTE 


> 30 LET AAAC2):=B+2%60 


eee cose sees save 


> 35 ONLY SINGLE CHARACTER STRINGS ARE ALLOWED IN AN EXPRESSION 


> 40 LET &AAC4) :="B"4C 


> 45 ALL MULTIBYTE STRING ASSIGNMENTS MUST BE OF EQUAL LENGTH 


> 50 LET &AAC2,S) :="ABCD" 


ebee cog onto cone 


> SS .THE FOLLOWING STATEMENTS WOULD GENERATE ERRORS 


> 60 LET &AAC2,3) 1: =B+%60 .LET &AAC2,3) MUST BE STORED WITH "Xx" 


> 60 LET &AAC4) 5 ="BC"+C ."BC" NOT ALLOWED IN EXPRESSIONS 


> 60 LET &AAC2,6):=“ABCD" sAAAC2Z, 6) ITS EXPECTING S CHARACTERS 


ene cose eee ence 


> 60 LET &AACO):=&AACL) 3 ="B" MULTIPLE STRING ASSIGNMENTS 


tase cece euae anes 


> 60 LET &AAC2Z,5)1:=4BR(7,10):="ABCD" »NOT ALLOWED 


2.6 Operators (Introduction) 


An operator performs an arithmetic or legical operation on one or 
two values resulting in a single valve. Generally, an operator 
has two operands, but there are unary operators that precede a 
single operand. For instance, the minus sign in A-B is a binary 
operator that results in subtraction of the values; the minus 
sign in -A is a unary operator indicating that A is to be 
negated. 


The combination of one or two operands with an operator forms an 
expression. The operands that appear in an expression can be 
constants, variables or other expressions. 


Operators may be divided into types depending on the kind of 


operation performed. The main types are arithmetic, relational, 
and logical (Cor Boolean) operators. 
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The arithmetic operators are: 


+ Integer ADD (Cor if unary, no operation) A + B Cor +A) 

“ Integer Subtract (or if unary, negate?) A ~ B (or -A) 

* Integer Multiply Ax* B 

/ Integer Divide A/S 

MOD Modulo; remainder from division A MOD B produces the 
remainder from A / HB } 


tn an expression, the arithmetic operators cause an arithmetic 
operation resulting in a single integer numeric valve. 


The relational operators are: 


ms Equal A = 
< Less Than Aa < 
> Greater Than A > 
{= Less Than or Equal To A ¢ 
>= Greater Than or Equal To A > 
<)> Not Equal A < 


When relational operators are evaluated in an expression they 
return the value ~-4 if the relation is found to be true, or the 
yalive 0 if the relation is false. For instance, A = B is 
evalvated as -i if A and EB are equal in valve, or as 0 if they 
are unequal. 


The following examples demonstrate the difference between 
relational operators and special relational operators in 
expression evaluation: 


i0 LET B:=6 10 LET B:=-10 
20 IF 1¢B¢Ci00 THEN S00 20 IF 4¢B¢i00 THEN 500 
IS EVALUATED AS IS EVALUATED AS 
4<6 = TRUE (-1) i<~40 = FALSE (0) 
€-4)94100 = TRUE (-4) CO><100 = TRUE ¢-4) 
RESULT "TRUE" RESULT "TRUE" 


Notice using relational operators doesn’t work in this type 
application. However, consider the evaluation of special 
relational operators (see Special Relational Operators 
(SECTION 6.0) regarding the Special Operators EQ, LT, GT, 
LE, GE and NE.): 


10 LET B:=6 40 LET B:=-i0 

20 IF 1 LT BLT 100 THEN S00 20 IF 4 LT BLT 100 THEN 500 
TS EVALUATED AS TS EVALUATED AS 
1¢6 = TRUE (~1) i¢-i0 = FALSE (0) 
64100=TRUE (-41) ~10¢100=TRUE (-1) 
TRUE AND TRUE = TRUE TRUE AND FALSE = FALSE 


RESULT "TRUE" RESULT "FALSE" 
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The Logical or Boolean operators are: 


AND Logical “and” A AND B 
OR Logical “inclusive or" A OR B 
XOR Logical “exclusive or" A XOR RB 
NOT Logical complement NOT A 


Unlike the relational operators, the evaluation of an expression 
using logical operators results in a numeric value which is 
evaluated as true (non-zero but not necessarily ~-4) or false (0). 


The Shift Operators are: 


LSL or LSR Logical Shift X LSL n (where n is any variable 
or constant) 

ASL. or ASR Arithmetic Shift X ASR n 

CSL. or CSR Circular Shift X CSL n 


For further descriptions of Operators, see Section 6.0. 


2.7 Reserved Variables C¢Introduction) 


AID reserves special locations for variables that may commonly be 
used or accessed from a known area. These locations are assigned 
names which become Reserved Varinbles. Reserved Variables may be 
altered or accessed as a variable (i.e. like A thru Z), however, 
caution must be used since some Reserved Variables are altered by 
commands and statements. The following List briefly describes 
those Reserved Variables and the operations that change them. 
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NORESPONS 
BADINTP 
CONCHAN 
FILELEN 
FILEINFO 
INPUTLEN 
MAXMEMOR Y 


PASSCOUNT 
RUNPARAML/3 


GOP ARAML/3 


OFFSET 
NOINPUT 


SECTIONSI/3 


STATENUM 


NEWTEST 


SECTION 


All other Reserved 
description of each Reserved Variable see Section VIT. 


If>0 then altered during bad 1/0 operation. 
altered by an illegal davice interrupt. 

set to the system cansole channel device. 

Set to file length after FILENAME, 

set to file information after FILENAME, 

set to character input length during INPUT. 
Altered during DB and BSIO/ESIO execution 
Stored with ~4i at run time 

During a CR statement, set to -i if the buffers 
compare otherwise the element number Cof the 
first buffer) which didn’t compare 

Optionally incremented by the BUMP statement 
Set to the value of any parameters passed with 
the RUN command otherwise 0 

Set to the value of any parameters passed with 
the GO command otherwise 0 

Set ta 0 after a RETURN statement 

Set to true with a SNPR command or false with 
an ENPR command 

Set to the approprinte bit mask combination of up 
to 48 section numbers input with the TEST 
command otherwise set to all "ones" at run time, 
Set to the AID program statement number of the 


most recently executed FUNCTION-calling statement, 


Set to true if’ a TEST command is antered with 
parameters and set to false after a TEST command 
without parameters . 
Set to the section number of a SECTION statement 
(if the SECTION is executed) 


Variables are set to zera at run time. For a 


2.8 Qperator Input Modes 


Three modes of operator input are available, 


These modes, 


discussed next in detail, are entry, execution and pause. 


2,808.4 


Entry Mode Input ~ Anytime a program is not executing or 
in a pause mode, AID is in the entry mode. 


Entry mode is 


identified by a prompt (>) and the next sequential statement 


number, 


Example: 


In this mode, 


command. 


44it- 8 


>» 40 


woes cove on aeue oney 


the operator may enter any valid statement or 
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2.8.2 Execution Mode Input ~ Anytime a program is executing, 
there are two inputs allowed: 


(41> CONTROL Y or ATTENTION~ initiates a break at the end of the 
currently executing statement and a message identifying that 
statement number, 


Example: Break in Statement 20 


Sted eAee wOEP OEE FONT OFS OEE SEES CHE OURS COE HONE Sone FaEE SEED HERD REEL OOD SEOT BORS Oren 


At this point any pause type entry may be made (see Pause 
Mode below). 


(2) INPUT Statement Execution - When an INPUT or INPUTE statement 
is executed, a question mark is prompted. Any valid numeric 
or alpha input(s) will be accepted. Each input must be 
separated by a comma if multiple inputs are requested. 


Example: INPUT THREE NUMBERS 


COee BOOS OOEH CFE CEFE HEED HOR ORES COED atER HOFd FEET SUES GOEn COMP HEbe Vere sees Cees 


2 1AF ,%37,40 


2.8.3 Pause Mode Input - Anytime ao CONTROL Y interruptk or 
pause~type statement has occurred, AID prompts with (>) and no 
statement number. At this point the operator may enter any valid 
command which affects program execution or control except EP, 
REN, SAVE, LOAD, SET, DELETE, INC and MODIFY. Program alteration 
is not allowed, but the operator may display any LIST data. 


For further explanations, see the operator mode state diagram 
(Section 1.10) or refer to the various statements and commands 
for input restrictions. 


KX AN interrupt during an I/0 operation is indicated by the 
message: 


Internal Break in Statement if 


Ord Cee Stns HOVE TOUR FOte ONES SOUR CEOS Same FhEE CERF FENG NeFE BOLE CODE BEDE COED SEOR LOEt COPS bmEe EETL BEEE atED Cae SEES FOE HOMY cous 


(Any pause mode input except LIST, PURGE, CREATE and LF may be 
made when this occurs) 
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2.9 Program Execution 


After the RUN command is issued AID must do some house cleaning 
before turning over control to execution of the program. This 
may couse a slight delay in the initial pass of the resident 
program, but subsequent passes will not be delayed. Also, during 
this house cleaning, errers may be detected that could abort the 
program (e.g. a referenced statement number is miesing). 


Assuming all goes well in the house-cleaning, execution 
commences, If an AID error occurs during execution, the program 
may abort and AID will return to the entry mode, 


The programmer should be aware of statements that cause large 
amounts of time to execute in case time is an important 
consideration (e.g. DER of a predeclared buffer which causes a 
pack of the buffer area), And, he should be aware of statements 
that consume large amounts of user area in case memory is a 
critical factor (e.g. Comments). A list of memory allocation and 
approximate execution times of statements is provided in 
Statement Memory Allocation and Execution Time Information Cin 
SECTION IT). 


If the program doesn’t loop it will exit by printing "END OF AID 
USER PROGRAM" and a prompt to indicate AID is in the entry mode. 


If the program loops or runs indefinitely the only way to ohort 
it is to interrupt(Control Y or Attention) and, after the prompt 
character is printed, enter the EXIT command. 


2.40 Error Reporting 


Three types of errors may be reported to the operator: entry 
mode errors, execution mode errors and program detection errors, 


2.40.4 Entry Mode Errors ~ Tf an If an error is detected in a 
statement or command just input AID prints a circumflex ¢*) 
under, or in the vicinity of, the character that generated the 
error and then prints an error message, 


Example: > 40 LET A:#%384 
ENTRY MODE ERROR 


Ag0b Guae C002 BREE OEE BORE ENED HEED F000 ONNE H408 Gate WEEP EDEY HEeh Cm 


HOA HOO 2000 CONE O9OE LENE 490% FORE ONbE EERE BEEN BEE ORES OER HOH CHET ONS YEEY Shir FONE SEUF CRED WHEL LEDd HED GOOE CHOD EtD sd EON0 EREE BONN OGes GORE Hee 208 


COOd COgD C0b0 GORE FOOr 8008 SOND HUES CERT LOT OEE EEE AUN CORD LOT LORE CaND Hobe POND HERD ORO BOT ETtD Wty BEES 


The error message implies the octal digit was illegal. 
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2,140.2 Execution Mode Errors ~- If a failure is detected during 
program execution which might cause a catastrophic failure in 
AID, the resident program is usually aborted and an error message 
is reported identifying the faulty statement. 


Example: > 40 LET AAC4) 1=B 


> 20 RUN 


EXECUTION MODE ERROR IN STATEMENT 10 


ee Eee 8eee sete 2OER F090 ERNE FOte CnRE SEED COED Sess CETE pene SbER FORD BERD SEED SEED Set DEE wane cece 


The error indicates the buffer accessed has not been declared 
with a DB statement. 


2.40.3 Program Detection Errors - These errors are detected by 
the user program and will not cause a catastrophic failure in 
AID. Documenting the errors would be the responsibility of the 
program writer, 


Example: INPUT A LETTER 


000 S6n8 Sess conn cone 9900 Sane Sees euNp RODE PEED SuRD SENN cone 


Cone 8000 4000 Soe BERS BETS ODED CFE LOEE BENE OTE DEEL TEED GOED SUED CODE CEES OODLE GEOL SEES COED SEES SEED BITS FEDS SOON FOES SEED Cane BETS FORD CORD SOCe COOP GIOT HERE COND oOed Cote 


2.44 Statement Memory Allocation and Execution Time Information 


2.44.4 Statement Memory Allocation ~- Every statement uses a 
minimum of three words of user area. In addition, any parameters 


entered occupy the following space: 
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Parameter Word(s) Used 

Operators (¢(+,-,MOD,etc,) 4/2 

Special Characters (!,2%) 4/2 

Constants 4-4/2 

Variables ¢(A~Z) 1-4/2 

Reserved Variables CPASSCOUNT, etc.> i-i/2 

Strings ("ABC") i+ (character length/2)% 
Data Buffers (CAACx)) 3-4/2 

String Buffers C&AACx)) 3-1/2 

String Buffers CA&AACK,y)) S-1i/2 

Comments i+ (character length/2)x* 


K Strings or comments containing character strings with more than 
four repetitive characters will consume less space because the 
repetitive string is packed into two words (i.e., "ABCDEFGH" 
would require four words and "XXKXKKKK" would require two). 
Note also that alternate spaces are packed into bits (i.e. "A 
BRC D" would require two words but "ABCDEFGH" would require 
four), 


From the table above a few helpful hints arise: 


-~ Use variables or Reserved Variables instead of buffers when 
possible. 


~ Use strings, string buffers and comments sparingly. If 
strings must be used, look for a trade-off in space (i.e. if a 
string containing more than about six characters will be used 
repeatedly, it might be beneficial to assign that string to a 
tring buffer for further manipulation or printing). 


-~ A comment following a statement text consumes three words less 
than a comment statement. 


Example: . > 410 SAVE XYZ VALUE 


2908 Ouse onee ser 


> 20 LET A:=AAC4) 


THE FOLLOWING SAVES THREE WORDS 
> 10 LET A:=AAC4) SAVE XYZ VALUE 


oo core cune cove 


~ Although it isn’t obvious from the table above, chaining LET 
statements saves a minimum of three words for each assignment 
and greatly enhances execution time, 
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ESSENTIALS OF AID 


aute S000 C000 Cnet Cade OPES OER EDEL COST eee BOD EEE PEED SEE SPES Cnet EOEL REDS GERD SEND OOEY CELE SOLD BEDE CORe HEEL COTE EETD SHES SORE SEES COE YEED DEED GOES BEES EELS une GEES HONE wen CED EUDS Coes OEE BESS SOeE VED SEtO CabE FEET SEES SEs Shad GHEE doe SERS OED Fens CODE COTD CaEE OOEt DENS SOLS SUES ETM Cems Seen Coee 


Example: > 10 LET A:=4 
> 20 LET B:=5 


> 30 LET C= 


THE FOLLOWING SAVES SIX WORDS 
> 40 LET A:=4,B:25,C:55 


eens seen 9000 cone 


THE FOLLOWING SAVES SEVEN AND A HALF WORDS 
> 40 LET A:=4,B:=€:2=5 


~ Savings are also derived by nesting LET statements in other 
statements when allowed. 


Example: > 40 LET A:=4,B:=5,.C:=6 


> 20 FOR A STEP B UNTIL C 


coe cnpe cone cone 


THE FOLLOWING SAVES SEVEN WORDS 
> £0 FOR A:=4 STEP B:=5 UNTIL C:=6 


2.44.2 Execution Times - Each statement requires about twenty 
machine instructions to start executing. This overhead is 
required for setting up certain parameters required for all 
Statements. 


Once a statement actually starts executing it may require as few 
as two machine instructions (e.g., SUPPRESS,ENABLE) or thousands 
to execute (e.g, DB, where the buffer has been defined 
previously), 


Since the “Time to Execute" to “Time of Execution" ratio of most 


statements is relatively high, it would behoove the programmer to 
compact multiple statements into one. 


44iB- 13 


ESSENTIALS OF AID 


SOG) eb98 VERE 950d SERS HECE OLNE ONES SURE 0600 GREE OED CODD GUEL DUDE OUDE EEOC 4200 ODED DDD 2450 CODD FORD SEED EOE OEGE LEED EEDE CORR 2000 BEDE SIDE CHIE DEUE BOEY FDEP ODED DEtd OED A009 GOD OPER 0000 HORS SUEE DERE COUR CODE HOOD DODD DEED GURL Seed F900 EPDE E540 BOLD F200 BUEE OEE BEDE ONS BEES SENS SUED DEES edEE B00 oDeD 0508 


Example: 


> 40 START THE XYZ TEST 


909 euee cone cent 


> 20 LET A:=4 


9Ots Gone once cee 


> 30 LET Di=SS 


CObE cent Ofte core 


> 40 FOR A STEP 3 UNTIL D 


S008 e908 nee conn 


BE CONDENSED TO 
> 40 FOR A:=4 STEP 3 UNTIL D:=SS5 .START THE XYZ TEST 


The first set of statements takes at least 9& machine 
instructions more to execute where! H 


Statement 10 costs &+ 
Statement 20 costs 45+ 
Statement 30 costs 45+ 


F&+ 
Here are some more time saving hints for programming in AID: 


* Comment statements cost 20 machine inestructions where comments 
in statements cost nothing in execution (see previous example), 


* FOR=-NEXT loops are much faster than IF<-THEN loops 
Examples > 40 FOR Ai™0 UNTIL 40 


> 20 LET AACA) mA 


> 30 NEXT 10 


WILL EXECUTE MUCH FASTER THAN --~ 
> 10 LET A:e—4 


sete cone sone ence 


> 20 LET AACA): =A: =A+E 


eee cone ever own 


> 30 IF A <= 10 THEN 20 


kX DB statements of previously defined buffers are very expensive 
because of the packing required for dynamic buffer allocation 
and should therefore be used sparingly. 
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aes coud ones sent ens BEES C000 SER) BESS BEES C50 NESS COEG EERE SEED ODED BEER BIOS COED CORE EEO BEDE DELS BEES ODES RIDE OFED FO) O00 ONES DORY CURE DERE FEED CORE ONES ENED SEED EbES FORE SEES SEE CONS SEES FOS CNPE OEPE HES FEDS SEDE DODD SENG CUDS TETD BUDD GNDD BEER GUN) EOGD BUNS CUTE CORE SEN) C100 SOEs BbtD URE SEBS C000 COt0 


Example: » 10 DB AA, 20 


100 DB AA,10 VERY EXPENSIVE 


we enen ence cone 


HINT: If space is available use another buffer instead. 


Example: > 10 DE AA,20 


>400 DEB BR,10 


* Chain assignments whenever possible. 


Example: > 40 LET A:=4 


> 20 LET B:=S 


> 30 LET Cres 


cone eons ogee soon 


May be rewritten to save at least 70 machine instructions as: 


> 40 LET At=4,B:=#5,C:85 


0008 e000 oes otee 


or even greater savings may be realized by: 
> 40 LET At@4, Bia, mS 


x Because of Inter~statement overhead, transfer of control should be 
made to the exact destination, 


Examples > 40 GOTO 50 


bape 8bee cote DUCE 


> SO BEGIN XYZ TEST 


> 60 SECTION 4,300 


enen ence cote veew 


Although harmless in appearance, the GOTO $50 should bypass any 
unnecessary or non-executable comments. The most efficient 
code would be: 


> 10 GOTO 60 


000 2000 omen vere 


> 50 BEGIN XYZ TEST 


Bebe Oey coey Maer see 
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ee0e A900 epee Cone DOSS sete wEte Coes CHEE Stee Gene PED Shee CECE SeEd Sone Sere 


3.0 AID COMMANDS 
The AID Commands 
in this section, 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN: 


3.4 CREATE 


OPERATION NAME: 


MNEMONIC: 


ALLOWED IN: 


DESCRIPTION: 


EXAMPLE CS): 


COMMANDS 


20k eee On0e Cane cess Stes FORE OOEe eee MELE eEEY Sete Bene DOES SENS BITE Bete DEEE FOES SEE Beer OEE HOUT BOLE FEES BEES FEEL OED COGS Sene Bete HOLE SEOY SEED SEOe EEEE CODE BEDE SEND ORME Utes HOES BOOT SOLO Grey NORE COED Beem OOES FEES SEte Cane Cnee 


available to the operator are listed, in detail, 
The format for each command explanation is: 


General phrase of what the Command does. 
The form that the Command would be called in, 


A detailed explanation of the Command’s 
Function. 


Describes whether the command is allowed in the 
Pouse Mode, Entry Mode or both. 


One or more examples using the Command. 


Create a new file 


CREATE filename, number of sectors [,revision 
level] 


Entry Mode or Pause Mode but not Internal Break 
Mode (See Pause Mode Input) 


Creates, i.e. adds to the directory of files of 
the Diaqnostic/Utility disc, a Data file named 
"filename" which will be the “number of sectors" 
parameter long. The range on the number of 
sectors is i¢=sectors<=available sectors left on 
the disc. See the Dinagnostic/Utility System ERS 
for further details. 


> 40 CREATE TEST,4 (Ccreates the Data file TEST 
a with a Length of 4 sectors), 


JUN 40, 4980 44iC- | 


COMMANDS 


2060 EODd OOD S108 WOOD Dubs SRE Hous ODED BEDE DEES FED HID FEED BEDE HOES SOLE DEST EOFS GORD SOE DODD CUEE GORE CODE OOD OOOD OEE DELS H9ED DODD SETS BEES HEDD ODE COED GOED 8010 BOO) LIED SOLD DOES OEE BEEP FELH FUDe O56) OEE DUES F000 OEE) O86 TEED FEED OOEd FOES BED OEEE O80 5244 HEDE DEED COED DODD HOES E62 Sten SOt Ewe OEE 


3.2 DELETE 


OPERATION NAME: 
MNEMONIC: 


ALLOWED IN: 
DESCRIPTION: 


EXAMPLE(CS) : 


3,3 EEPR 


OPERATION NAME: 
MNEMONIC } 
DESCRIPTION: 


44iC- 2 


Delete statements) 


DLIELETE] first statement number[/last statement 
number ] 


Entry Mode Only 


Removes the statement specified in first 
statement number from the user program, If the 
last statement number parameter is entered then 
the statements from first to last statement 
number are deleted, 


> 100 DELETE 20 


(remove statement 20) 


one or 


> 1400 D30/40 


tee woe sete cone sees 


(remove statements 30 through 40) 


Enable Error Printout 


EEPR 


Enables AID to print error messagesk, This is a 


default condition and would normally be used only 


after a previous SEPR Command, 


NOTE: Default is error print enabled, 


t44ic00p.t t44icbi.t 


ee ewe we 


COMMANDS 


00s S000 OBE0 OFF SEED OFEe SONS SEED HEC GLEE SHED SEES COED BEDE SEE SOE BEES HOES eOEe BEES UEEE SUED BEOE SEED OORT DERE SEES FOES CODE HOES DUDE SOOT OED BOLE DED FEED ODES SEED O60 MES Sete WEE DOOD UOTE HUES OOS BEDE OFsE BENS FED0 FEES eEEe Ott EEE SEES CEES OUEE DEES D1De OEE S000 OOOO COED FEET COTS OREN EOP OH tOtE TENE 


ALLOWED IN: Pause Mode Only 
EXAMPLE(S); > 440 RUN 
CATTENTION) 


Brenk in Statement 80 


C008 COD 64m CFEs CREE SEDI Cade C000 BtTE OEED BORE BORE Coed BEES SEED EDEL SEEe SEES ETET Stee Sete 


KX These messages are those contained in the EPRINT and PRINTEX 
Statements only, 


3.4 EEPS 


OPERATION NAME: Enable Error Pause 

MNEMONIC: EEPS 

DESCRIPTION: Enables AID to generate an error pausex after an 
error, This is a default condition and would 
normally be used only after a previous SEPS 
Command, 


NOTE: Default is error pause enabled. 


ALLOWED INi Pause Mode Only 
EXAMPLE CS): > 440 RUN 
CATTENTION) 


Break in Statement 20 


BOP 9900 8800 CDOF BEDE SEED ERED CODE BEE OOSE O1ER GOED eee DerD BEE CEES OuEe DenE USES Dene Cree 


KX These pauses are those contained in the the EPRINT and EPAUSE 
Statements only. 
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COMMANDS 


9908 COO HORE FORE BOD CUES ORE SOHS COLE CIDP DEEE NEE ERT BOE CHO COTE SOte EOE BEDE COED COOP BSE DONE SECT CUED BOLE COED CEES CEES EOD OEE SOFE HIST DODD ODED DUES BEET SEED CODE SOE DODD SONE SESE SEE SEED CONE HOOT SEES EECD ECEE SECS LETH O7DF BEOU HUES HOT) COED SPEE LODE OuEs OECD OFS TEER SOD DEED SEP enOD SUES Dene vere 


3.5 ENPR 


OPERATION NAME: Enable Non-Error Printout 
MNEMONIC: ENPR 


DESCRIPTION: Enables non-error messaqesx* to be printed and 
operator response to a message to be 
acknowledged. This is a default condition and 
would normally be used only after an SNPR 
Command was previously entered. ENPR sets the 
Reserved Variable NOINPUT to false. 


NOTE: Default is non-error print enabled, 


ALLOWED IN: Pause Mode Only 
EXAMPLE CS) : > S50 RUN 
CATTENTION) 


Brenk in Statement 4190 


4000 COhe 4008 $008 GOES SEE0 2OER C008 C00 Fede ORES WEEE FELD CETL 2009 SOLO BOER EOE COFe oe Fete 


> ENPR (Enable Non~error Print) 


KX These messades are those contained in the PPRINT and PRINT 
Statements only. 


3.& ENPS 


OPERATION NAME: Enable Non-Error Pauses 

MNEMONIC;: ENPS 

DESCRIPTION: Enables non-error pausesk during AID program 
execution. This is a default condition and 
would normally be used only after a SNPS command 
WAS previously entered. 


NOTE: Default is non-error pause enabled, 


ALLOWED IN: Pouse Mode Qnily 


AMiC~ 4 


Anew C008 cane S000 Bees CORE SORE BORE BED COLE CEES OOS COTE SENS EELS COTE DEED BEES DOLE SOLD COTS WHEE ERED CEES SEES GEES BEDE CERT EIEE COKE SE0E Bete BEES CEGE SEES SOEs NEES Fane See 


EXAMPLECS): 


> SO RUN 


CATTENTION) 


Brenk in Statement 10 


etee cece cees Coes Sens CO0e Stee CEE COND SEES FOES COTS SEND COE Gare SEES Cone CORE CEES Sate oeee 


K These pauses are those contained in PPRINT and PAUSE 
Statements only. 


3.7 EP 


OPERATION NAME: 


MNEMONIC: 
DESCRIPTION: 
ALLOWED IN: 


EXAMPLE CS): 


etee e902 sees sree eons 


eee S000 cess cess esee 


Erase Program 
EP 
Erases the resident AID program from memory. 


Entry Mode Only 


»LAST LINE 


EP 


CONFIRM YOU WANT TO ERASE THE CURRENT PROGRAM CY OR N) 


C00b C009 eObe OREO Yams 8000 DOES BOE SOEe CUES HONE HESS C0OS SETe SES SORE FETE EIEE BOOS COLE FOES SodE DOES DEED FORE DO>FE BOLE EEE CHEE SOE SFEE HObe ONES wien CEES FOOD CHOE SHEE FOES COOL SOS BOE WEE SEED Gene Heed 


? 


PROGRAM ERASED CIf this message doesn’t appear the 
pig eee erie tae program is intact.} 


> 19 


eee coer coe cece 


JUN 40, 41980 
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444C- 


(ee case Sere S0Ce Cees Cee OOEE CEES FONE FOND SEES ete CEE HES FORT HOES EEO CODE DEES bere SHOE EEE CEES HUES HOLE COL) eOEt SITE DeEe SEEe Stee 


ee OE ee OE ee me le ome 


S 


COMMANDS 


HOOF S000 O66 FOES EEO SORE HOES BORE 4008 HABE OOOE BOF ONEL 2ETE BEDE 800 GOED CODE OODE BEES GOED SEED BEET FORD RUE 004 OETE S000 S100 eBED BAER O9EF COEF DEED SEDE ODES BEES SEED CEES OEDE CODE EEE FPOD FREE BEE OOF0 C080 9000 CEE GREE FECL DEED DUDE BODE BODO DEES DERE CODE HERS CEES HEED O40) S4EF NONE COTE DEES DEHd DEES DUES Suse 


3.8 EXIT 


OPERATION NAME: Leave Proaram Execution 
MNEMONIC: EXIT 


DESCRIPTION: Stops ALD program execution and returns to the 
entry mode, If AID is in the entry mode then 
EXIT returns to the Diagnostic/Utility System, 


0000 ente cose coos exes 


CONFIRM YOU WANT TO ERASE THE CURRENT PROGRAM CY OR ” 


S08F 8ODe SRE CORE SHOE HOES CEPT 008 SESE OEY CODD EDEL GREE FOES CEE OED REEL SFRE COTE BES 2009 GHEE BILE CEES C000 SORE BOUE EELS SEES S400 SEE SEER SEEE SEDE COTE OUOE SEES 2006 DEES Ott CEs POEL CUNT SESE S0E0 BENE GEE COTe BONE Ede 0108 ene 


7 ¥ (a N response will return the operator to che 
= AID entry moded 


Enter Program Name 
{ 


ALLOWED IN: Pause Mode or Entry Mode 
EXAMPLES): 
> 50 RUN 
(ATTENTION) 
Break in Statement 30 
END OF AID USER PROGRAM 
>S0 READY FOR NEXT STATEMENT) ! 
“or | 
> 400 EXIT 
H 
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3.9 GO 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


ALLOWED IN: 


EXAMPLE CS): 


3.40 INC 


OPERATION NAME: 
MNEMONIC : 


DESCRIPTION: 


COMMANDS 


A0ee C668 COOn CORE COEF SUES FERS BEES SObe Doe SEED SENS EOO0 SUED DOOD COLE SEES OTOL See BEDE SORE EEEE DORE S0EE CEES OEE CEE SEES EFSD BORE BEDE BETS SEDI MEE FODE EEE HELE OEED eDEy F008 CODE DERE BEES SHES CINE FEED HERD DOOD SEEE FEDS SEFC GHEE CODE CHEE EONS HEEL BOG2 HOEY emnE HOES PEE HO10 OtEE GOED UNE SORE ORER tees ENCE cone 


Continue Execution 


GO (Gill, (G210,637) 


Causes the present AID program to continue from 


the point at which it paused. Up to three 
parameters (G1/G3) may be passed which are 
accessible by the program with the GOPARAML/3 
Reserved Variables (additional parameters are 
ignored). The parameters are delimited by 
commas and are assumed to be decimal integers 
unless preceded by a % or ! (see Special 
Characters). Default parameters are assigned 
the value 0. 


Pause Mode Only 


> 400 RUN 


008 conn coms cece one 


DISC NOT READY, READY DISC AND CONTINUE 


S000 ewe Gere Cebe Sees S068 Hees SELs SEE SEED CEO FEES 4EEE BFE SONS DEED BEDE BEES CECE FUER EECE BEE? Senn DENS SEEC Beet COED SEEt SERS Sete OEE Stns CEES sens etee Cums SHEE Snes Cone 


> GO (PROGRAM EXECUTION CONTINUES GOPARAMi 
ite THROUGH GOPARAM3S EQUAL 0) 
or 


> GO,,2 (THE THIRD PARAMETER (GOPARAMS) IS 2 
= AND THE REST ARE 0) 


or 


GO 8 (THE FIRST PARAMETER (GOPARAM1) IS 8) 


~~ 


Change Statement Increment 
INC X 
Allows the operator to change the statement 


increment value without renumbering (see REN 
Command), The new value X will take effect 


after a valid statement is entered with a number 
greater than or equal to the existing statement 


number, 


JUN 10, 1980 441C- 
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wT PE we O88 we we ww 
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COMMANDS 


1OCS S000 DvED CEOE F008 SUBS WEEE DELe Sane HERE CEES SELL SEE REEL COET EODS SuSE SEED FOND FOYE EOEE BERS CREE BERD FECL OEE FIED SPIT ete BEES HOGS EDS SEES DERE SET CODE BREE CODD 42ES EETS OESD ETE SOY COED HELE SENS HEED BEES SETS Sees HOEE BETS EDEE BED CELE HELE 2000 COED COED HOEY HED SEES SORE DEE O02 GEES eEbS BEDS BeES Soon 


ALLOWED IN: 


EXAMPLECS): 


3,44 Le 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN: 


EXAMPLE(S): 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN: 


44iC- 8 


Entry Mode Only 


> 10 LET A:=4 


> 20 INC i 


were eee e100 seen 


> 20 GOSUB 200 


same coon acee esce 


> 24 (Note~ increment is by one and not 10) 


seen suas 00s cee 


List Commands 
LC 


Lists the commands that are available in AID. 
The entry mode and pause mode commands are 
Listed depending on the mode AID is in at the 
time of the LC command. 


Pause Mode or Entry Mode 


>» 40 LC 


(Lists the entry mode ATD commands) 
or 
Break in Statement 590 


AAO e000 Soe Coes UIE NES SEES POEL CBE 2400 GREE DEES SEED DEED G95 FOES OFEE HOE SO0% SHEE weer 


> -EG (Lists the Pause mode AID commands) 


Cea 


List Files 

LF SPERINTER DI 

Lists the files that reside in the 
Diaqnostic/Utility Dise directory. For further 
information refer to the Dingnostic/Utility 
System ERS. 


Entry Mode or Pause Mode but not Internal Break 
Mode (See Pause Mode Input) 


JUN 40, 1980 


me ee me 


Reve 9000 Sees CUE SePe BEES SOFe AEEe CUES Gram KOOe GUED SORE EEE SEES BOE BEDE OOEE SEER OEnd FORE MOET REE COED COLE OHNE ORES DEO EGR Cone BEES BORD BOLD FEED BEES HERE SOO EES LOEe Goat Seey Cone SOne veee >F1 


EXAMPLE (CS): 


OPERATION NAME: 


MNEMONIC;: 


ALLOWED IN: 


DESCRIPTION: 


COMMANDS 


eed WOE cove eene SEee OESe FORE mtEG SEES FEED SOR sEEE Cone COED Hee Hout GOR OEFe Sete cent cane 00s cone tees seen 


> 40 LF (See Diaqnostic/Utility System ERS for 
eee printout information 3 


LIST 
LETIST] CPLRINTERIJ] (CDATA TYPE] {statement number] 
[RI 
[Vi 
CRI 
aon 


Entry Mode or Pause Mode but not Internal Break 
Mode (See Pause Mode Input) 


Will print the information requested to the 
console device. If the optional [PRINTER] is 
entered the LIST will be printed on the printer 
device. If DATA TYPE is specified the listing 
Will be in that type (i.e. ! for hex, “% for 
octal else decimal). Any LIST may be terminated 
with CTRL Y om ATTENTION, 


If using the IDS as console, hold down CTRL and 
Shift keys simultaneously to temporarily 
interrupt the listing. It will resume when you 
release the keys. (This is an IDS firmware 
feature it is not provided by the AID 
interpreter, ) 


Listing formats are: 


Entry 


cove emns 4088 4602 cose 


LIST Ux/y] 


LIST C 


Meaning 
List the present AID program, x 
causes a one line list of statement 
x, VY Causes a multi-line list of 
statements x throuvah y. 


List the value of PASSCOUNT, 


LIST R £€,x] List the Reserved Variables. 


If x is entered then List only that 
Reserved Variable. 


44iC- & 


COMMANDS 


Cost GREE BON C108 208 2004 Stan 2000 DEbd LOFe BOE LODE Done OOF O49 EEE SOOT F000 2084 SeDE OELE FOOD CORE FEOF 2000 SES BOER SERE SUPE PERe DEOL HOF EFTF OECE FORE SE88 Fhe HOOD G00 HOSE DEE HOD TELE HOEH HEY F980 SOHO GORD HEEE AEEE OLED CREE FEDS CURE HOOT HEHE ODDO OPED OOEL EERE EEED FEOF FO0D enED BOEs F2Ee SEED HEE 2508 OFEe 


WARNING 


The reserved variables VALUES to VALUES and 


NAME’ to NAMES con 
pertinent only to 
gtatement, 


LIST Vi t,xi 


Entry 


LIST BEyx,y/2d 


tain information that is 
the use of the FUNCTION 


List the variables as follows: 


If x is not entered then List all 
variables (A ~- 2), If x is entered 
then List only that yvarlable, 


Meaning 


Weed eee vies WEEE done teDe CHOe 


List Buffers as follows: 


Tf only & is entered, then list all 
buffers and their lengths in the 
order of the statement numbers where 
a1 DB or BSIO occurs, If «x is entered, 
ligt the entire contents of buffer x 
(If x is a string buffer then list in 
ASCII with a header that desiaqnates 
the character numbers). With data 
buffers if y is entered, List only 
that element of buffer x. If z is 
entered, list all elements of buffer 
x from vy to Zz. 


EXAMPLE(S): SAMPLE PROGRAM LIST 


> 60 LIST 


4600 cee see ence 


> 40 XYZ DIAGNOSTIC 


ance vase case cose C000 O000 8B0e 2008 c0es DORE sees saEe GORE Heer Eee BEDE On0e cree BEE 


> 20 WHAT 


see gees S60e seer 9008 gens cote sees anee 


> 30 GA 


> 40 FUNNY 


neve ene s008 onee 4208 epee 0008 oun eee 008 


> 50 PROGRAM 


> 69 


ener ease ame gee 


A4iC~ 40 


COMMANDS 


90e OORE A00d O00 OPE BEDE ORS SOLE COLE BETS BEOE ELEE BEE ODE COTE EE0E FOES BORE COLE ObES S400 EID COED BUDE SEED OEE FEEL FEES SEED SEO ODE) SOLE CRED DOLD G00) HOOD ECE FEES PELE DEOL SOLE DENS OED BUEL SHEE OUCH SEs OOOF TELE BSED DetE EEE GORE SOOG FEED CORE FORE ONEL Late CO00 SEE CEES COO) SFeH bume BENE OnE UOT 


SAMPLE VARIABLE LIST 


> 440 RUN 


00s meee e401 s60e sone 


CATTENTION) 


Break in Statement 40 


> LISTIV,A 
A= IF6 
> LISTAV ,F 


FH 


ma 4366 


> LIST V 


A= 246 B= 10 C = 43 D= 4. , 
i] ‘ , 1 Zz = 94 
SAMPLE DATA BUFFER LIST 


> 200 RUN 


CATTENTION) 
Break in Statement 40 


Whee Seed ence BOCs BOE eves teen SEES SET SEEe ECE SeEe SnEe OOOH Sate OEEE NEES 400d SEED CEte CORE 


>» LIST & 


STATEMENT NAME SIZE 


40 AA 20 (AA is 20 words long) 

100 & BE 6 (ABB is 6 bytes long) 

150 DD KSTOK (DD is declared as BSIO DD, It’s 
length is indeterminate? 

>» LIST B,AA , Will List the 20 elements of AA 

AAC O ) = 44 2& ' ‘ ' ‘ r ‘ ’ ' ' ’ ‘ ‘ ‘ ' ‘ ' ‘ ' 43 

AACSB) = 76 44 t 4 i} ‘ ‘ t s 9 6 ‘ 1 t ¢ ‘ 1 t t 40 


AACLO) = S 10 77 34 


>LIST B,AA,I/3 . Will list elements 1-3 of AA 


AACL) = 26 14 4 
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COMMANDS 


Pde woes CASE OOD OO0s Gene REET HOES AEEe CORE SPE BEET FEET HODE DOSE DOLE DORE EEES OES SEDh PEED OEE CURE DEED SDE SORE FREE SORE HEF BOGE BEEE SEES HEED DEES CORE FOOD BEE HEEL Ons OEE BEES CEES EONS FOES ODER SEES CODE SEER FEED BEE HEED EEED FUE ODES CEES SEE SEER COED OEE CORE SEES EOEE CORE ROOD BEES Sane HOEY HES Dene OOee 


PLIST PRINTER B (Will List all presently defined 
- buffers on the Printer Bevice)d 


SAMPLE STRING BUFFER LIST 


Any character outside the range !20¢=character value c!7E 
will be replaced with a circumflex (*) for continuity in 
listing Ci.e. characters 20 and 24 in the following 
exanple are a carriage return and a Linefeed?>., 


LIST B,&BB (Will List a header which identifies 
each character position ino the string 
in increments of 70 Ci.e. in the 
following example the character D is 
in the 7Oth character position) and 
then lists the contents of the ABB 


buffer > 
0 4.0 OW! 28 So lobre Gace e oui aad aes 60 69 H 
+ + + Ce ee ee ee ee + + H 
JKLMNOPQRSTUYV wees i 
DEF i 
3.44 LOAD 
i 
OPERATION NAME: Load Proaram 
MNEMONIC: LOAD filename 
DESCRIPTION: Allows the operator to load an AID program from 
disc (see the SAVE command). Any statements 
entered before the LOAD are erased and when the 
program i8 loaded AID responds with a normal 
prompt with the next sequential statement number 
following the loaded program. 
> 
ALLOWED IN: Entry Mode Only 
EXAMPLE CS) : Assume the AID program on the dise ends at 


statement 4276, 


> 440 LOAD TESTPROG CINITIATES A READ FROM THE 
eS toi DISC VIA DUS) 


A4AiCe 42 JUN 40, 1996 


3.45 LOOP 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN: 


EXAMPLE CS): 


COMMANDS 


sees O800 eens cae SOs COLE CONE COS F004 Cone Sete CELE HTEe Cote SEme BEES Here FERS BOEY OEE DFOE HOLE HEED SEES ELL BEES LENE SOUS CELe FOLD HOEe GHOd OLE HORS COON COTE HOES EEO BEES OEES EYE Dane BED SEES COTS CLES SEES HOSE BEE FORE SEED Bird ene SEES Stes GEES Cae EOEE Hone SOLE SARE Ot1e OOOe SHOE HEDe eHee tte Coes Seen COte 


CONFIRM YOU WANT TO ERASE THE PROGRAM CY OR WN) 


Rete 600 ares ence woes SO8d SOME URES Fane HOES CREE HOE COLE wens CHEE CREE BEES OES FORE GOED HOEY FEED COTE NEES BOEe OTE ODEs DEED EEE GHEE EOEE BEOE Ute vane BOSE Sane CECE OEE CEE SORE eure G1ne Seee TOE Sate oFee 


ies (A "Y¥" RESPONSE WILL ERASE THE 
cd CURRENT PROGRAM AND LOAD THE NEW 


PROGRAM, AND A "N" RESPONSE WILL 
CAUSE NO ACTION TO OCCUR). 
Program Loaded 


ee eC i ee ero 


The Next Available Statement Number is 


OPee wre CObe SO8e Sees OES CmEe BOOS ERLE EOOH HERE HHEe CALE OHT OENE BODE FEED GOES COOH LONE S088 BERD BOE OLD comm HHDD OOH SRDS OES BEEE See ben MEEe BEES HOSE BEDE Otte eter 


> 4280 


00s 0008 caee coos ease ooee 


CLOAD SUCCESSFUL. THE ATD PROGRAM TESTPROG ON 
DISC IS NOW IN MEMORY AND ANY VALID STATEMENT 
OR COMMAND MAY BE ENTERED). 


Set Loop Fiag 

LOOP 

Sets a LOOP flag that, during program execution, 
Wild cause a LOOPTO statement branch to occur 
(See the LOOPTO statement). Sea the LOOPOFF 
command for resetting this flag. 


Pause Mode Only 


> 400 SECTION 14,200 


> 200 SECTION 2,500 


> 500 LOOPTO £00 . Branch to Section 4 if LOOP commanded 


JUN 40, 1980 44ic~- 


ae Late let let ee ee eT) 


43 


COMMANDS 


$3.46 LOOPOFF 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


ALLOWED IN: 


3.47 MODIFY 
OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


ALLOWED IN: 


44tCe~ 414 


Clear Loop Flag 
LOOP OFF 


Clears the LOOP flaq that was set by the LOOP 
command. See LOOP command. 


Pause Mode only, 


CATTENTION) 

Break in Statement 200 

> LOOPOFF (clear LOOP flag meaning exit the 
AID program normally upon 
completion) 


Modify Statement 
MEODIFY] Statement Number (€/Statement Number] 


Provides a means of editing the ASCIT text of a 
statement, When the MODIFY command is entered 
with an existent statement number AID Lists the 
statement, Any character editing may now be 
done by entering a key letter under the column 
to be edited. This editing fenture allows 
inserting, replacing or deleting characters. 
After the edit is complete the operator may 
delete the old statement number and add the new 
by simply pressing ENTER, or he may lenve the 
old statement intact and add the new by entering 
"J" (meaning JOIN), If more than one edit type 
LS entered only the first edit type is 
acknowledged. Any modify may be aborted by 
entering "A", 


Entry Mode Only 


JUN 10, 1980 , 


U8 OOb8 Fees tone oOEt Hove Bind Ete ane2 CREE ONE Fee tee FdE2 ceEE UID REED coEE ERE GrOR E2ED SHEE FES LELD SHEE LOE ETE BENE CLO GENE FOES EOL LEON Rese HEL vODE HoEe EEO GORE Foes SHOE HORE Fore REED sett OoEE ERT eFOD CEDE EERE ONDE HORE EGO RODE NeEe SOee Rese snte etvE dot2 GeTe ERED 2080 Ses Sore SHEE Lene Dees OORP seet 


we ae oe 


—— aoe 


O90 OveD Nee CETE BONE etY REECE CTD Core ERLE BOGE FoEe CBE HOED GREE LoD Fete ba 


EXAMPLE CS > 4 
> 400 M40 


10 Let 


40 LET 
RF OR 
40 FOR 
DDDD 
40 AACD 
CENTER > 
> 100 
> 100 M30 
30 . ABC 
RSQ 
50 .ABC 
CENTER ) 
> 100 


> 100 MSO 
50 . ABC 
Ri 
150 .ABC 
J 
> 4160 


fone eoee cose ste stee 


$3.48 PURGE 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN: 


tt 09Ge POET OELE EOEE GONE PREF FEne DUTT ORPE HOUR COED DEE DORE CENT FETE HODE CREE EDD DOOR ate StEE FED OEE CODE CINE OEtE ELIE NEED FORE REF Fee LONE MOOD Cote BEDE FEED the DEED DONT Cone tree bEED GOEL Feet ene pene Cred 


Ay mg 
TACO) CINSERT ACO)) 


AACO) 124 
(REPLACE LET WITH FOR) 


eens bene a0ee eens sees tone 


AAC 0): =4 


(DELETE FOR ) 
yy 34 
(REPLACES STATEMENT 410) 


(DELETES STATEMENT 30, ADDS STATEMENT 50) 


m Oyo 


(PRESERVES STATEMENT 50, ADDS STATEMENT 150) 


Purge a File 
PURGE filename 
Removes the file "filename" from the 


Dinanostic/Utility Disc directory, See the 
Dingnostic/Utility System ERS for detuils. 


Entry Mode or Pause Mode but not Internal Break 
Mode (See Pause Mode Input) 


JUN 40, 4980 44iC~ 


COMMANDS 


ee ee ee ew ee we ee Om we Om ww WY we Om we Rm we BE Be RM FE wm mem om ae oO we 


COMMANDS 


S0hd O08t VEE Came Gbee Smee Seer SEW CHEE ELE HEEL SESE SOOn BEDE SIDS GEES UES OEE BEDS REEF BEET BEES FECT BEES DOS GEED CODE HESS CEES EEET SEED SEES SEES EERE EERE SEED SEDE SonD CEE COEe DUDE SOLS ELLE CORE OFEE WEEE SEES CNEL CEES COEF CEES SEES CELE BODE BEES FEE OTH BEDE TEES FEES EOE COEF SHED EEEE Bene OHHe CENe DEEe Bete vase 


EXAMPLECS): > 40 PURGE TEST (Remove the file TEST from the 
alae directory} 


3.49 REN 


OPERATION NAME: Renumber Statements 


MNEMONIC: REN [Ec] ; 
where c=(statement multiple >=4 and default is 410) 


DESCRIPTION: Renumbers the existing statements as specified 
by the statement multiple, If the renumbering 
will exceed 9999 an error is reported and a new 
number must be entered, ALL] references to 
Statement numbers are also changed to reflect 
the new Statement numbers. 


ALLOWED IN: Entry Mode Gnly 
EXAMPLECS): oe | 


nee ween cece ence 


> 20 GOTO 30 


eeee sone ecee cose 


> 30 PAUSE 


ease cece ence eves 


> 40 REN (DEFAULTS TO STATEMENT INCREMENTS OF 
Soe 40 WHICH MEANS THE PROGRAM DOESN? T i 
> 40 LIST CHANGE IN THIS EXAMPLE) 

> 10. 


wane cee e190 woes Bete eee SOE cbse Cooe one aces 


> 20 GOTO 30 


cece Seed One cote ence 42n8 BEEE Bees nese cone COPS Sent ene 


> 30 PAUSE 


POee seer sees cree cane sees e200 were ose seen nner 


> 40 RENS 


neon cece seco cece 


> 42 LIST 


wens sees esse ovee 


> 3 


> & GOTO 9 


> 9 PAUSE 


seston sind “oven owes oesn ten saben es 
> ie 


44iC~ 416 JUN 40, 1980 


COMMANDS 


F000 Bee CEOS SOS FEE Seve CUES SEED eEED FICE SOnd SUTe SOUS EPEE HEED SOE EEDE HEEL HORE BERS SOLE CONE NEED OEEE HOES HEE HELE SOLE ONES TELE HOLE EHUD GUEY POLE Cote CORE LEER eHEe FOE BEES EEO OER RULE BEDE SEED EERE ORES FEDS OES SEE DOFG CUPL OESE EOE EEE OURS BERS Sree OECe COED COED CEES GEER BERL LEDS COOH webs HOt HeEe want 


3.20 RST 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN; 


3.24 RUN 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN: 


Resets all execution state flags to the default 
state: 


~ Error Pause is enabled CEEPS Command) 


Error Messages unsuppressed (EEPR Command) 
~ Non-Error Messages unsuppressed CENPR Command) 
~ Non-Error Pauses enabled CENPS Command) 


Pause Mode Only 


Initiate Execution 


RUN EPZi3,0, €P2it, €P317] 

Causes the resident AID program to initiate 
execution from the lowest numbered statement 
reqardless of the state of execution. Up to 
three parameters (Pi/P3) may be passed into the 
RUNPARAML/3 Reserved Variables for use by the 
program Cadditional parameters are ignored). 
parameters are delimited by commas and are 
assumed to be decimal integers unless preceded 
by a 4 or ! (see Special Characters). Default 
parameters are assigned the value 0. AID resets 
agli variables, buffer pointers and indicators to 
their default valves except the LOOP and TEST 
flags and information. 


The 


Pause Mode or Entry Mode 


44iC- 17 


COMMANDS 


COOR CFOS OFSE FENG ESET LITE EEEE HONE EAE GET BEES O9OR HEEL F298 SORE CIEE OEE HOST 9008 2088 CNET FIDE OSD HEET 202E SEDO OUND CSD GEES BEDE SEAR FEST DOSE 2ESF DEST OEEE ERO SEND Dare HEED EEE FOOT NEE pee EEEt TEST eves N02 FOOD NOEs INST HELE NEO THA LOL Bre COM NEED ROLE SEES LES FET Shes SeeF FHRe SORE FER) Coes sen ceR 


EXAMPLE CS) 4 


3.22 SAVE 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


44iC- 18 


) 400 RUN /RUNPARAMS THRU RUNPARAMS = 0 


(ATTENTION) 


Break in Statement 20 


G68 080 C000 OREO SER HEEE CODE OEEE SEEF EOEE Gene 4PEE E9E0 BEES GOES DONE e800 F000 GeED o00 Sone 


> RUN 
This sequence would restart program execution 


(ore st08 or eran onee 


> RUN 41,,3 (THE FIRST PARAMETER CRUNPARAML) IS 
ASSIGNED THE VALUE 4 AND 
THE THIRD CRUNPARAMS) THE VALUE 3) 


Save Program 
SAVE filename [,revision leveld 


Allows the operator to save the resident AID 
program, in binary, on the dise via DUS Calso 
see the LOAD command). Nothing is altered in 
the AID program and, after the SAVE is 
completed, AID returns to the entry mode, If the 
optional revision level is entered filename will 
have that revision, If no revision is entered 
filename will be assigned a 00.00 ravision 
level, 


NOTE: If room does not exist on the diskette 
for the file, the message “Insufficient disc 
space” is displayed. Since going to DUS will 
cause the current AID program to be lost, follow 
this recovery procedure: . 


JUN 40, 4980 


ALLOWED IN: 


EXAMPLE CS): 


3.23 SEPR 


OPERATION NAME: 


MNE-MONTIC: 


DESCRIPTION: 


COMMANDS 


HOG8 F000 CORE SORE DENT GOES FO0E HOLE D0ER Sent DERE RENE FOE) CIEE EOEE OED EREE BEET SOE OEEE PeEE COE BEDE 2008 SUE BEL COTE BEDE DODD EERE DEFT ENED BODE BONE FEET FORE SORE DEEd fESE DEES DEEL MET Cand DENT FURL DURE SONE SnEE FOE ENED FEE NEED FETE EDEN MERE FONE CONE DONE DENe GOnE DoG0 BENE REGS HEEL HERD EEO OtEe GEte HOW sDeR 


(4) Inert another Diagnostic/Utility diskette 
which has more space 


(2) SAVE the current AID program on the second 
diskette 


(3) Re-insert the original Diagnostic/Utility 
diskette 


(4) Use PACK command to attempt to open~up 
space 


(S) Rer-insert the second Diagnostic/Utility 
diskette 


(6) LOAD the program. 


(7) Re~insert the first Diagnostic/Utility 
diskette 


(8) SAVE the program 
Entry Mode Only 


>» 4280 SAVE TEST, 01.02 


e000 0000 aces ones Smee cone 


PROGRAM SAVED (ANY OTHER MESSAGE INDICATES 


se as a a ec cette cae NO SAVE OCCURRED) 
> 4280 (SUCCESSFUL SAVE! ANY VALID COMMAND 
wot st sn OR STATEMENT MAY BE ENTERED) 


Suppress Error Printout 
SEPR 


Suppresses error messages and error pausesk until 
an EEPR or RST command is acknowledged. 


NOTE: Default is error print enabled. 


JUN 10, 1989 44iC- 


—- ae ow ow 


19 


COMMANDS 


WOEd OOD0 C008 S000 EOE S804 COLE Bee EERE GEE FLEE HEEE ORES OORT CIDE COED OFEE SEED CEE BERD SESE SOOT SOEE TOES COE BEDE OEE SESE SEDE CODD COTS Ged CODD CEES COED CEEE COED SEED OUEE eEEN CODE DEES SOUP HEE COED HOTS FETS EPPO SORE EEEE DEED SOLD FETE SEED COTE EUS OEE HOES OOOO Bee EOE EEE ROTE EONS HOLE ETEE CODE Coe Cute Sete 


ALLOWED IN: Pouse Mode Unly 
EXAMPLES): > 440 RUN 
CATTENTION) ig 


Break in Statement 20 


EUtO Cane eon COOP E800 C800 CORE UEEE HESS SEND LEDS BODE SEER OIE CORE BODE CEES Cone ONES ene Tet 


*X These error messages and error pauses are those contained in the 
EPRINT and PRINTEX Statements only. 


3.24 SEPS 


OPERATION NAME: Suppress Error Pause 
MNEMONIC: SEPS 


DESCRIPTION: Suppresses error pausesx from occurring. The RST 
and EEPS Commands will override this condition, 


we ae 


NOTE: Default is error pause enabled, 


ALLOWED IN: Pause Mode Only 
EXAMPLE(CS): > 440 RUN 
(Attention) 


Break in Statement 596 


8000 9OOe 4000 OO0D BORE SOOO EOED CECE BOLE BEEE OD GOES Sane BEDE SObe DEPP FOE SOE SOFt cues Sone 


> SEPS 


xX These pouses are those contained in the EPRINT and EPAUSE 
Statements only. 


444C- 20 JUN 40, 1980 


COMMANDS 


e00s ene ene S000 eOOe woes SEOe CEE OES Hone COLD GHEE GENE OOS BEET BFOE CORE COC COLE BFRE BOED SEES COTE FORE HOOE ERO SORE CORE SEDO SORE EVER HEED FEED TORE BOSE HEED SEES HELE CEOS eEED OOEE SOLE BEES SOES CODE EES NERD Stee S000 BEDE FOES sOde SEES OOP FEES SOT CEES SEED Sted LEED HOOT SEES CORD SORE HEL HERE 4900 nN FOND See 


il 
Pa 
ut 
3 
rr 
+ 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


ALLOWED IN: 


EXAMPLE CS): 


A typical 


Set New Statement Number 
SET Statement Number 


Allows the operator to set the current statement 
number to any valid statement number. If an 
existing Statement number is encountered while 
sequencing because of the SET command a warning 
message is issued which informs the operator 
that a valid statement entry will delete the 
existing Statement. 


Entry Mode Only 


> 10 LET A:=4 


e000 sees gore cone 


> 20 INC i 


S000 woe este cove 


> 20 SET 8 


wees cone cess coon 


> 8 LET Bi=4 


> 9 GOSUER 50 


Caos cose onte sree 


KKWARNING ~ NEXT STATEMENT ALREADY EXISTS&k*k 


Sees S008 cons CE0e c0ee SOee REEL HERE BOOe SHOE BOER SOON BEER REDD HANG GELE SEES FORD OFSD SEES CORE DEE OEDe SO>Dd HERS COVE DOTS DEED DED EES SEE COED BEES SEES OLED eEED CORE SOEs Cese SOEs eOte Bee vOet 


> 40 SET 20 (RETURN TO ORIGINAL STATEMENT ENTRY 
faunas STATEMENT £0 IS NOT ALTERED) 
> 20 


etee see cee seen 


application would be: 


>» 50 GOSUB 900 


coos coos aece cone 


> 60 SET 909 


eee cece eons seer 


900 BEGIN SUBROUTINE 


>» 4040 RETURN “END SUBROUTINE 


ees cece ener cece eee Hee 


> 4020 SET 60 


eee cece wenn seen cone ween 


> 60 (RETURN TO ORIGINAL MAIN PROGRAM ENTRIES) 


Pees ence shee e000 came ores 


44iC- 24 


COMMANDS 


0998 C000 C008 ERD REEL S90F OnEe SENT DERE SENT OTET ONS NORE OPER CIS SOUP SEND EOEE ODE OFDD ESD BOOT GOED HOOP ERED HERE SESE CATE CODE BOND SEER HOUT DENT UOTE DEED STE GENE GtET HONE FEET POET BOOT OOET ONDE SOLE CODE PLDs ENED HOSE tHEt HUET OEE NFET BADE CEES COED CFT HEEL s0ER UOTE SOOT BOE HONE EOTe CONE Ente Sate Let e9tn cot 


3.26 SNPR 


OPERATION NAME: Suppress Non-Error Printout 
MNEMONIC: SNPR 


DESCRIPTION: Suppress non-error messagesk on the Console, The 
RST and ENPR Commands will override SNPR. SNPR 
sets the Reserved Variable NOINPUT to true and 
does not allow INPUT(B) statements to be 
executed, 


NOTE: Default is non-error print enabled, 


ALLOWED IN: Pause Mode Only 
EXAMPLE(S) : > 440 RUN 
CATTENTION) 


Break in Statement 40 


600 2000 Oabe Anee OESE BEDS C600 GENE COEF COED CEES S080 FIED HEEE SORE SORE GEEe ORND SONY CORD One 


* These messages are those contained in the PPRINT and PRINT 
statements only, 


3.27 SNPS 


OPERATION NAME: Suppress Non-Error Pauses 


MNEMONIC: SNPS 
DESCRIPTION: Suppresses non-error pausesk during AID program 
execution, 


NOTE: Default is non-error pause enabled. 


4A4iC- 22 


9900 0O8D Bete BEED D0Ee REEE FEED SeED Coee Cite CORT SERe ODED eteD BEES oREE 


ALLOWED IN: 


EXAMPLE (S): 


COMMANDS 


(900s ODE 9000 GONE SORE RENE SUED CONE SEED EDSE MULE CIDE FEET SEER Gent DPE BOOT ENEE POEL FETE BOOP DERE BODE EHNE DONE VOID OEEE ENOL ORS DEED BOE NEES HIDE LOGE HOOF SOEs DENS HERE HOUT FONE GENE CENS BEE GORE SEDE SeEt eene DUES DEES RODE CoLs GIND HERE ONTy 


Pause Mode Only 
> 440 RUN 


2000 C008 Sat AEne cene OEFS 2000 4000 ORY bene GEOD SEND SEED BERD SORE GEEe SEED SER H0E0 DOSE SEDT 


KX These pauses are those found in the PPRINT and 
PAUSE Statements only. 


3.28 SO 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


3.29 TEST 


OPERATION NAME: 


MNEMONIC: 


DESCRIPTION: 


Shut off streaming 
So 


Streaming is not implemented; SO acts like EXIT. 


Section Test Select 


TEST C+ or -TEXLE/YI,2Z11 
TEST ALL 


Allows the operator the capability of externally 
selecting program sections to be executed. The 
optional + or ~ adds or deletes the following 
test sections from the current test section bit 
mask; absence of the + or ~ deletes all existing 
test section bit masks before continuing. The 
optional slash (/) indicates inclusive sections 
L.e.~ 3/5 means test sections 3, 4, S. The 
optional comma (,) indicates separate test 
sections (i.e. 1,3,5 means test sections i and 3 


and 5S). Section numbers may be entered in any 
order but the section number must be greater 


44iC- 23 


COMMANDS 


2000 S000 COdh 9460 SEHD 4090 S050 EOEe SAPS Bee SEE OORT O00 OEEE HOES CONS SERS EOFS BEET BEER SOLE SORE BERD BOLE HEED CO00 CIEE DEES OEOY SHEE OEEE HEED ELED HEED FIED FEED OFE0 SOD CHER OED BEE OPES OOOH HOEY SESE GOOD BFE) ODES BEDE CAE0 HOES COEF BEES CESD FURS BEDE DIES OPE S90E wEnd EFOD ELLE DEES OEDD FEE FeBe coer COED SHFe EERE 


then 0 and less than 49. Whenever TEST is 
entered with parameters the Reserved Variables 
SECTIONSL/3 are set with bit masks correlating 
to the section numbers (see Reserved Variable 
SECTIONSL/3) and the Reserved Variable NEWTEST 
is set to true (see Reserved Variable NEWTEST). 
If TEST is entered without parameters the 
NEWTEST Reserved Variable is set to false and 
the bit masks in Reserved Variables SECTIONSL/3 
are set to all ones. If TEST ALL is entered all 
Test Sections are selected (i.e. ALL bits in 
SECTIONS. ,SECTIONS2 and SECTIONSS are set). 


ALLOWED IN: Pause Mode Only 
EXAMPLES): | 
> TEST 4/3,5,7,9/44 CINDICATES SECTIONS 4£,2,3, 
- 5,7,97,410 AND 14 ARE SELECTED) 
or 
> TEST 10 CINDICATES SECTION 190 
= IS SELECTED) 
or 
> TEST (SETS THE NEWTEST RESERVED 
aa VARTABLE TO FALSE) 
> TEST + 4 (ADD TEST 4 TO THE TEST 
ce SECTION BIT MASK) 
>» TEST - 6 (REMOVE TEST & FROM THE 


TEST SECTION BIT MASK) 


See the Reserved Variables SECTIONS1/3 and NEWTEST and the 
statement SECTION for further examples and explanations. 


441C- 
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JUN 40, 4980 


Oe Oe ee 


ee? ee 


STATEMENTS ~ NON-I/0 


200 Gane GEe WOOD SEOE Sete O54 OFFS EPEO ODES DHE S90 BEOd BODE SEED hERE SEES OES DOES FEET SEES COE DEOL FOUL OFDY STUD CODE ESOS LEED SEES EELS SERS BEDE FEC0 COED BEES SEEN FES HOLS OSE EPSE COST FEET COED SORE CORE ORE BEEY HONE OdEE SEED EHEL FOES BITE OFFS FLEE COE COLE ODE SUEE HEED HED EOEE Gent HEED OEDE BEES UES HONE FEEe 


4.0 AID STATEMENTS (NON I/0) 


The AID statements available to the operator are listed, in 
detail, in this section. The format for each statement 
explanation is: 


OPERATION NAME: General phrase of what the statement does, 


MNEMONIC : The form that the statement would be called in. 

DESCRIPTION: A detniled explanation of the statement’s 
function. 

EXAMPLES : One or more examples using the statement. 

4.14 ASSIGN 


OPERATION NAME: Assign Data to Buffer 


MNEMONIC: ASSIGN data bufferCelement)., (repeat 
factor) 1],datai £€,data2]...,..€datan] 
DESCRIPTION: Stores data into a data buffer, The word datai 


is stored into data buffer Celement) and, if 
included, data2 is stored in data buffer 
Celement+id, and so on through dataN, which is 
stored in data buffer Celement+N-i). If repeat 
factor is included the data pattern is repeated 
repeat factor times. Datai through dataN must 
be numeric constants. 


> 410 DB AA,100,2455 JINITIALIZE AA TO £55 


>) 20 ASSIGN AA(SO),5,10,45,20,25,30,35 
mmm (AACSOIES, AACSII=10, . . . AACS6)=35) 


> 30 ASSIGN AAC1O) ,(10),!1FF 
wma CAACLO) THROUGH AACL9) D=!IFF) 


> 40 ASSIGN AAC80),(5),3,7 
women CAACBOI=3, AACBID=7, AACB2)=3, AACBS)=7...AA089)=7) 


> SO LET A:=80,F:=5 


e000 sees soee cqve 


> 60 ASSIGN AACA), (FD ,3,7 »IDENTICAL TO STATEMENT 40 


Aone eras eoee cove 


APR i0, i979 A4iD- i 


STATEMENTS ~ NON-1/0 


908m SHOE H90R OEE GORE BOED FRET FORT GEOT BERD OEE Dene FORT CURE CONE COE CERT SEH TEES FORT tEGE ZENE AEST CRED FORE GORE CONE FORE OSE GOEE TORT CONT REET REDE NESE COTE FECT CENT COER F908 BRET FEED EODE DESE FONT C980 COTE FER OFEE GOEL CREE DOSE CORE COED GEFT GOEE COER Cet SEN EEN DONE SEE CORE ODED BNET O400 DOOE SDE SHEP bane 


4.2 BUMP 


OPERATION NAME: Bump Pass Counter 
MNEMONIC: BUMP DE ;JCHI 


DESCRIPTION: Increments the Reserved Variable PASSCOUNT 
Cunless the H parameter is used) and then prints 
that pass count on the Console. The pass counter 
(Reserved Varinble PASSCOUNT) is initialized to 
zero whenever a RUN Command is issued. Printing 
may be suppressed by a SNPR Command and, if the 
optional semi-colon follows BUMP, no return~line 
feed will be issued after the pass counter value 
is printed, The PASSCOUNT is limited to 32767. 


EXAMPLES (2): >» 40 BUMP H 


gate othe cent ene 


> 20 RUN 


eee enee vane pene 


END OF PASS 0 (NOTE~ PASSCOUNT is still 0 after the 
Re eee aoe iia ms geeeeie= print because of the H paramete 


> 40 BUMP; 


eee 2002 cone seen 


> 20 PRINT “FOUND A BUG!!" 


tren cone cose agee 


> 30 RUN 


ee sete gree cose 


END OF PASS 41 FOUND A BUG! ! 


ee cass Gree COE ONES EOED SEF HEEE OEE EDED HEEL COED EERE BEFO AEE SEN) SORE EbES BEEP SEES EESD SEER EPES oteE SHES seus ROER 


4.3 CB 


OPERATION NAME: Compare Buffers 
MNEMONIC: CB Buffer 1, Buffer 2, Length of Compare 


DESCRIPTION: Provides a fast comparison between the contents 
of two buffers (two string buffers or two data 
buffers). If the buffer arens compare, the 
Reserved Variable INDEX is set to ~1, 

Otherwise, INDEX is set to the element of Buffer 
4 which didn’t compare (see INDEX under Reserved 


44iD- 2 t44id0ddp 


STATEMENTS - NON-I/0 


O000 260D G0EE OhET SESE DOSE ENST GtDT ERLE NEED COED DERE SEDE LENE SONS DEED CERT FRET COED HERE BEDE HOES 9FGR H0EE GOD EODP ONES EERE FEET EDGE DADE ONDE NERD DORE CONE CREE NETR GOTT OPED BEDE SHOE VERE 0000 FOE DERE Gene SENT GOED GD CEES FORE CEES PNET CODE NNO CONE BANE EERE Opte GTP FEN LOEt spSE NODE 


Variables). 


The length of the compare is in words (Limit 
32,767) Lf comparing data buffers and bytes if 
comparing string buffers. 


EXAMPLES) : 

>» S CB AACLO), BBC10), 10 » COMPARE AAC10)~AACL9) 

> 40 » WITH BBC 40)-BBC19), 

» 45 IF INDEX <> -i THEN 200 . REPORT ERROR ROUTINE AT 200 

> 20 CB &4CC(S), &ADDC10), 6 . COMPARE BYTES S-40 OF &CC 

» 25 . TO BYTES 40-45 OF ADD 

> 30 IF INDEX = -4 THEN 100 » IF INDEX = -4 THEN COMPARE 

) 35 . WAS GOOD 

NOTE: If a Compare Error occurs in statement 20, the programmer 
is responsible for remembering that the buffer elements 
nre offset Ci.e,, &CC(S) is compared to &ADDCL10), not 
&DD(S5)), 
(Comment) 


4.4, 


OPERATION NAME: Comment String 


MNEMONIC: » (period) 


DESCRIPTION: Allows entry of comment strings as statements or 


following statements. Any entry following a 
period (.) will be interpreted as a comment 
string for the pending line (the only exception 
is a period inside a string). Comments should 
be kept short, concise and ysed spnringly since 
they can only be maintained as source data thus 
consuming a lot of user space, 


EXAMPLE(S) : 
> 10 #4. THIS [8 
> 20 .A COMMENT STRING. 


ene anne e00e cane 
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> 30 GOTO 40 »THIS ITS A COMMENT STRING 
> 40 PRINT "STOP. THEN GO" 


(This does not indicate a comment string) 


4.5 DB 


OPERATION NAME: Define Buffer 


MNEMONIC: DE Name, Length [,assignment data] 
DESCRIPTION: Declares a buffer with a two (alpha) character 


name (AA, BB, ...ZZ) and a buffer length up to 
the allowable space availablexk (see MAXMEMORY 
under Reserved Variables). The parameter length 
is interpreted as a numeric (0 will delete the 
buffer). The only assignment data allowed at 
declaration is a string assignment for string 
buffers (see example) or numeric or variable for 
data buffers where the entire buffer is stored 
with that numeric or variable value. Dynamic 
allocation of buffers is allowed, but may cause 
large overhead in execution time since existing 
buffers are "packed" to allow room for a new 
buffer, Dynamic allocation will leave the 
existing element values unchanged. 


EXAMPLE(S): 

> 40 DB AA, 4100 ,DECLARES THE BUFFER AA AS 100 WORDS 
ve LONG 

> 20 DB AAA, 10 DECLARES THE STRING BUFFER &AA AS 
a .40 BYTES LONG (NOTE AA AND AAA 


»ARE SEPARATE BUFFERS). 
> 30 DB &CC,100,"START". EACH SEQUENTIAL S BYTE SET OF &CC 
ite -CONTAINS START 


2008 coer opne ween S906 


> 40 DBCC, 100, 0 “STORES 0 IN ALL 100 ELEMENTS OF CC. 
> 50 DB CC, 41140 »REALLOCATE CC TO 440 WORDS 

Seer (FIRST 100 ELEMENTS INTACT) 

> 60 DB CC, O DELETES BUFFER CC 


ooen sore eee ween 


XA Limit of 32,767 words is set for data buffers. String buffer 
length is limited to 65,536. 
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4.6 DELAY 


OPERATION NAME: Delay 

MNEMONIC : DELAY increment 

DESCRIPTION: Provides a delay of program execution in 
approximately 914,.43k microsecond increments, 
The maximum delay increment is 65,535 (5.99 
seconds), 


KBased on current system clock. 


EXAMPLECS) : 


> 60 DELAY 18 (SUSPENDS PROGRAM EXECUTION FOR 
pene 914.3 MICROSECONDS) 

> 400 DELAY i (SUSPENDS PROGRAM EXECUTION 
art 91.4 MICROSECONDS) 

EXAMPLECS): 

> 420 DELAY A (SUSPEND FOR Ax91.4 MICROSECONDS) 
4.7 ENABLE 


OPERATION NAME: Enable Errors 

MNEMONIC: ENABLE 

DESCRIPTION: Re-enables program execution error reporting 
previously disabled by a SUPPRESS statement or 
the commands SEPR and SEEPS. 


EXAMPLECS) : > 100 ENABLE (ANY SUBSEQUENT ERROR WILL NOW BE 
se eae REPORTED DURING PROGRAM EXECUTION) 
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4.8 END 
OPERATION NAME: Stop Program 
MNEMONIC: END 


DESCRIPTION: Indicates the end of the existing program execution, 
END may be used anywhere in the program and does 
not have to be the last statement, 


EXAMPLECS) 5 > 410 LET Ay=4 


pebe oete pete cone 


> 20 PRINT A 


The above program is identical in execution to: 


> 40 LET A:=4 


> 20 PRINT A 


> 30 END 


e008 open noes ones 


END may be used anywhere to terminate the program 


> S LET Ar=4 


ease eeep ened cone 


> 40 GOSUB 30 


oent eure geet coun 


>» 20 END »END PROGRAM AFTER GOSUB 30 


>» 30 LET ArFA + fi 


one eone ence ones 


> 40 PRINT A 


een 9008 sone seen 


> 50 RETURN 


4.9 EPAUSE 


QPERATION NAME: Error Pause 
MNEMONIC: EPAUSE 


DESCRIPTION: Creates an unconditional pause in the execution of 
the resident program, This statement is suppressed 
only by the SEPS command and SUPPRESS statement. 

A prompt character (>) is printed on the console, 
the operator may enter any valid command, 
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EXAMPLLECS) : >» 40 EPAUSE 


>» 20 RUN 


» (Any valid command may be entered) 


4,40 EPRINT 
OPERATION NAME: Print Error Message to Console 
MNEMONIC: EPRINT (€%)] Caetring [,¢Cor3)] Ceatring] etc.) 


DESCRIPTION: Enables data,print spacing# or strings to be 
output to the Console. This statement must be 
used to print error messages only (see PRINT for 
non-error messages), This statement will only 
be suppressed by the SEPR command and SUPPRESS 
statement, The optional (x) disables the pause 
following the print. If the Reserved Variable 
STEP is greater than zero the error message is 
preceded by a STEP number message (See Reserved 
Variable STEP). 


EXAMPLE(S): 
> 40 EPRINT ABBCO,7) “ABB PREVIOUSLY SET TO "BAD UNIT" 


e000 sees sete exes 


> 20 EPRINT * 4BBC(0,7) 


qoee sven even enee 


>» 30 RUN 
BAD UNIT CREATED BY STATEMENT 10 
>co 
bap UNIT CREATED BY STATEMENT 20 


000 cote CBO 6000 coe Gene enee Bene SEES FORD Hees DEES Fase Sete OSS enER CoeL SOME CODE CeCe Seen SONY O00 


wore woee (7 oven over 
> 40 EPRINT "DATA WORD "3A; "IS"; !BRCJ)3;" SHOULD BE "3; ICCCS> 
>» 20 RUN 


DATA WORD S IS !F8D4 SHOULD BE !F7D4 


OHO 9086 CROP C080 ROTO C000 COtD SEOE GOCE SEED COS DEED DERE COED CEES Bete FEDS RET SEED SH00 PEE COED GuSe DEF STOR SOE CODE COTE Gade SOOT Gone EDS cORs COtT COED enEe 
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# See Print Spacing under Special Characters. 


4.44 FILENAME 


OPERATION NAME: Set Filename 
MNEMONIC: FILENAME string buffer [,offset! 


DESCRIPTION: Specifies the filenamex pointed to by the string 
buffer parameter be used in future file access 
Statements. The optional offset is the sector 
number from the start of the file to start 
subsequent file accesses from (default is 0). 
The string pointed to in this statement must 
contain a valid and existent filename during 
execution and must terminate in a space or !FF 
character, Also see the CREATE command and the 
READFILE and WRITEFILE statements and FILEINFO 
and FILELEN Reserved Variables. 

EXAMPLE(S): 


> 10 DB &AA,9, “FNAME123 " 

> 20 FILENAME &AAC0) | | 

~--~ (ALL FUTURE FILE REFERENCES WILL ACCESS THE FILE 
NAMED FNAME123) 


-or- 


> 100 FILENAME &AAC2),5 

vow CALL FUTURE FILE REFERENCES WILL ACCESS THE FILE 
NAME AME123 STARTING FROM THE &TH SECTOR 
I.E.-SECTOR S OF THE FILE) 


* The file “filename” must reside on the Diagnostic/Utility 
Disc being used and must be a valid filename as specified 
by the Diagnostic/Utility System ERS. 
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4.142 FOR-STEP-UNTIL 


OPERATION NAME: For-Step-Until 


MNEMONIC: FLOR] assignment exp [STEP exp] UNTIL(or TO) 
terminator exp 


DESCRIPTION: Provides a means of repeating a group of 
instructions between the FOR statement and a 
subsequent NEXT statement using a variable as a 
counter (the variable cannot be a string buffer 
element). The STEP parameter is an optional 
increment of the FOR variable with a default of 
1. The FOR-NEXT sequence is repeated until the 
terminator expression value is exceededX® by the 
FOR variable value. FOR statements may be 
nested. Note that no execution occurs in the FOR 
statement after the initial execution. Note 
also that UNTIL or TO may precede the terminator 
expression but UNTIL will always be listed. 


EXAMPLE(S): 


> 40 FOR T: = 5 to SO .WILL EXECUTE THE STATEMENTS 

a a .BETWEEN 410 AND 100 (46 TIMES) 
‘ WITH T=S THRU I=S0 STEPPING 

' .ONE AT A TIME 

> 1400 NEXT 10 


mene nee coos S000 sone 


> 40 FOR I:=5 STEP 8 UNTIL SO 

oo ne .WILL EXECUTE THE STATEMENTS 
' .BETWEEN 40 AND 400 (6 TIMES) 
WITH I=5,43,241,29,37,45 

> 400 NEXT 40 | 


done cece nee Dees sew 


> 40 FOR I:=5 STEP B:=8 UNTIL C:=50 

eas »THIS SEQUENCE PROVIDES 
' »THE SAME SEQUENCE OF 

‘ ~STATEMENTS AS ABQVE 

> 400 NEXT 10 


wees cone e000 seen cove 


> 40 FOR AAC2):= -S TO SO 
sc (AAC2) WILL STEP -S,-4,-3,-2,-41,0,4...50) 


> 400 NEXT 10 


oene ened 2000 ance cone 
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KIf the STEP valve is negative the sequence will repeat until the FOR 
value is less then the UNTIL value, 


(Note: The FOR loop always executes at least once.) 


4.13 GOSUB 


OPERATION NAME: Go to Subroutine 
MNEMONIC: GCOSUB] Statement 


DESCRIPTION: Allows the program to enter a subroutine and then 
return to the next sequential statement% after the 
GOSUB statement. Nesting subroutines is allowed 
to 20 levels, 


EXAMPLECS): > 10 GOSUB 500 ‘GO TO THE SUBROUTINE STARTING 
>» 20 ... :AT STATEMENT 500, 
> 490 GOTO 600 »SUMP AROUND THE SUBROUTINE. 


> S00 LET A:A+4 eTHIS SUBROUTINE 


> S10 PRINT A; AWILL INCREMENT A 


> $20 RETURN “PRINT IT ON THE CONSOLE AND THE 
“RETURN CONTROL TO THE STATEMENT 
“FOLLOWING THE GOSUB WHICH CAUSE 


»TRANSFER OF CONTROL TO SOQ. 


¥See the Reserved Variable OFFSET for returning to other statements. 
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4.14 GOTO 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLE CS): 


4.45 IF~THEN 
OPERATION NAME: 


MNEMONIC: 


DESCRIPTION: 


STATEMENTS - NON~-I/0 


GO TO (Unconditional Branch) 
GOTO Statement Number 


Allows the program to branch unconditionally to 
another statement number, 


> 40 GOTO 50 » TRANSFER CONTROL TO STATEMENT S 


If-Then Control 


IF exp CCSPECIAL OPERATOR expI(SPECIAL OPERATOR exp] 
THEN statement number 


Allows the executing program to evaluate "exp" 
and if it’s true (non~zero)X to transfer control 
to the statement number specified. "Exp" may be 
a simple variable, data buffer element, 
assignment or expression. Expressions may be 
separated by a special relational operator not 
allowed in any other expression. The allowable 
special operators are: 


GT (greater than) 

LT (less than) 

GE (greater than or equal to) 
LE (less than or equal to) 

NE (not equal to? 

EQ Cequal to) 


WARNING 


String buffers are handled as data buffers in 
this mode, i.e., &AACO):=S would store &AACL) 


with S,. 


EXAMPLE CS): 


Each expression is evaluated and then tested 
(left to right) with the special operator. The 
result(s) of the special operator evaluation(s) 
is logically ANDed and if the overall result is 
true, control is transferred to the THEN 
statement. Up to three expressions are allowed. 
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> 40 IF AAC2) THEN SO .IF AAC2) IS TRUE (NON-ZERO) GO 
on TO SO | 

> SO IF B:=C THEN 30 THE ASSIGNMENT IS EXECUTED THEN 
wt toe s-EVALUATED. 


> 70 IF A OR B THEN 30 . THE EXPRESSION "A OR B" IS 

a ,EVALUATED, 

> 80 IF 44 LE A:=A+4 LE 20 THEN 120 | _ 

oo me .TEST IF A+4 IS BETWEEN 44 AND 
20 INCLUSIVE, 


> 90 IF A:=A+i GE Br=B+i GE C:=C+4i THEN 200 | 
“ae .TEST IF (A+4))=( B44) = (C44) 


2400 IF i LT BLT 4100 THEN 20 | . . 
oa -TEST IF B IS BETWEEN 4 & 100%*, 


* See IFN Statement for the reverse branch condition, *xXNote that 
‘statement 100 would not execute the same as IF 14844100 THEN 20 
which executes as "IFCi¢B)<100 THEN 20" where the result of i<B 
will equal -i or 8. 


4.46 IFN-THEN 


OPERATION NAME: IF-NOT-~THEN 
MNEMONIC: IFN exp THEN statement 


DESCRIPTION: Identical to the IF-THEN statement (see IF-THEN) 
except the expression “exp" is tested for 
falsity in determining if control is passed to 
the label “statement”. The expression valve is 
not altered by the NOT function. 


EXAMPLE(S): 
> 40 IF 4 LE ALE 44 THEN 20 


ae .IF A IS BETWEEN 4 AND 44 GOTO 20 
> 20 IFN i LE A LE 44 THEN 20 


Seana .IF A IS "NOT" BETWEEN 4 AND 14 
GOTO 20 
“OR | 
> 40 IF A THEN 20 LIF A¢)0 GOTO 20 
> 20 IFN A THEN 20 LIF A=0 GOTO 20 


vee cove o9ey one 
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4.17 INPUT 


OPERATION NAME: 


MNEMONIC: 


DESCRIPTION: 


EXAMPLECS): 


10 INPUT A 
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Input Data 


INPUT x,CyJ],...€n) 
I x,Cy],..€n] 


Provides capability of receiving operator input 
from the Console and assigning that input to a 
variable (s). x may be a simple variable, buffer 
element, string buffer or Reserved Variable. 
When executing, input prompts with a ? or ?72 to 
signify an input is expected (see Special 
Characters). Each input value must be separated 
by a comma, Inputs may be an ASCII character 
but not ! or Z alone. Also change in character 
type will terminate input but not necessarily 
report an error. Additional input beyond the 
expected is ignored. All ASCII characters are 
shifted to upper case. See the Reserved 
Variable INPUTLEN for determining the character 
length of the input. 


AVALUE INPUT FROM THE CONSOLE IS 
»INTERPRETED AND THEN STORED 
-IN A 


30 INPUT AAC2) JAAC2Z) WILL BE STORED WITH THE 


ents eves case ctee 


~INPUT VALUE. 


40 INPUT &BR(2,6) »ELEMENTS 2 THROUGH 6 OF STRING BUFFER 


enes ence ence teen 


»&BR WILL READ THE FIRST S CHARS INPUT 
«FROM THE CONSOLE. STRING BUFFERS MUST 
.BE USED IF ASCII INPUT IS REQUIRED. 


SG INPUT A,B,C »THE OPERATOR MUST INPUT THREE 


60 INPUT A 


70 RUN 


? 47776 


IF 4 


»NUMERIC VALUES (SEPARATED BY COMMA 
»DELIMITERS) TO BE ASSIGNED TO A, 
.B AND C 


(STATEMENT £10 EXECUTION A:=4£7776) 
(STATEMENT 30 EXECUTION AACE! :=IF4) 


(STATEMENT 40 EXECUTION &BBC(2,6):= 
"HELLO" > 


441 D~ 


ig 
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7? 2,4 (STATEMENT SO EXECUTION A:=2, B:=4) 
27? «8 (STATEMENT SO MORE INPUT REQUIRED 
sara C:=8) 

? #B (STATEMENT 60 EXECUTION A:=%102) 


4.18 INPUTB 


OPERATION NAME: Input for buffers 
MNEMONIC: INPUTB XXC¢N) 


DESCRIPTION: This statement allows variable length numeric 
input into a buffer, XX(N) is the first buffer 
element. Commas may replace data to suppress 
input into that element. String buffers are not 
allowed. 


EXAMPLE(S) 1 
> 410 DB XX,7,9 “Fill XX with nines 


> 20 FOR T:=0 UNTIL 6 Print initial XX contents 


> 30 PRINT XXCI93435 


nee qtee cone sees 


> 40 NEXT 20 


(000) Gant gene cove 


> 45 PRINT 


ete eeee ecco enne 


> SO INPUTB XX(0) Get input data from operator 


> 60 FOR L:=0 UNTIL 6 Print XX contents with input valves 


> 70 PRINT XXCI)34; 


> 80 NEXT 60 


> 90 RUN 


99VDIVDO®D 
2 1,2,3,,5 
9923989 


Note that XX(0), XX¢4), XX€4) and XX(6) are not changed by the input. 
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4.19 LET 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLES): 


> 10 LET A:=10 
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Assignment 


C(LET] variable:= Any variable, numeric, expression 
or string 


Allows assignment to a variable, data buffer or stri 


buffer the value of any variable, numeric, expressio 
or string. 


‘A TS ASSIGNED THE VALUE DECIMAL 10. 


> 20 LET Cr#D+é .C IS ASSIGNED THE SUM OF D+E. 

> 30 LET AAC2):=IF .ELEMENT 2 OF THE BUFFER AA IS ASSIGNED 
Soe » THE HEXADECIMAL VALUE F, 

> 45 LET AssCi=4 sMULTIPLE VARTABLE ASSIGNMENTS ALLOWED. 
> 48 LET Ai=4,B:=7 “MULTIPLE EXPRESSION ASSIGNMENTS 

aed ALLOWED, 

> 50 LET AAC4):1=5 sELEMENT 4 OF BUFFER AA IS ASSIGNED 


.THE VALUE OF THE B VARIABLE. 


> 60 LET &AACS,9) 12@"HELLO" 


taeg 2900 se00 ause 


> 70 Ar=40 


e000 2008 8050 coe 


AAACS, 6) HE, &AAC7,8)=LL, &AAC9) =O 
»IDENTICAL TO STATEMENT 10x 


> 80 LET A:=B<C A=—-i if BCC else A=0 


o0et woes eteg cees 


KThe LET keyword may be omitted but a subsequent List will display it 


4.20 LOOPTO 


OPERATION NAME: 
MNEMONIC 1 
DESCRIPTION: 


EXAMPLE (S): 


Conditional Loop Branch 
LOOPTO Iabel 
Causes a branch to the statement specified in label 


if a LOOP Command was previously issued otherwise no 
action occurs. 


>» 400 SECTION 1,200 
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> 500 LOOPTO 100 . Go to 100 if LOOP flag is set. 


4,21 LPOFF/LPON 


OPERATION NAME: Control offline listing 
MNEMONIC: LPOFF/LPON 


DESCRIPTION: Print statements normally have their output 
directed to the Console, LPON statements may be 
used to direct the print output to the line 
printer%®, LPOFF will direct the output back to 
the Console. 


EXAMPLE(S): > 10 PRINT "This will go to the Console" 


enee evte case cone 


> 20 LPON 


> 30 PRINT “This will go to the line printer" 


> 40 LPOFF 


sess ape cote sees 


> SO PRINT “This will also go to the Console" 


> 60 RUN 


* If no line printer exists the print will default back to the Conso 


44iD- 16 


4.22 


OPERATION NAME: 


NEXT 


MNEMONIC: NEXT 


DESCRIPTION: 


N x 


STATEMENTS ~ NON-1/0 


Aes Gane ates anes eres COE SNe METS OPLE CURE OURS BODE SEND SEED COED GEE GOED DEAD SESS SEER OFOD DEES BOOED SEED ETSY CODE FetE OENE SOde CEES SUES GES EPES SEED Sets CODE Bene SETS BETS FOEs CEES EERE SEDE TEE FOES EEED DORE CORT SECU SEED SOEE GOES GeEL TERE SEES TIES COGS EOOd PETE Sore GOED Rene COVE EYES HOLE SOLS Sete FOES URED teen 


End of For-Next loop 


x 


Specifies the end of a For-Next set of statements 


where x must be the statement number of a respective 


FOR s 


EXAMPLES): > 10 


cose onpe cece epee 


> 20 


esas Save eree coer 


> 30 


> 40 


eete sete eeee sees 


This 
.. BE 


4.23 NOCHECKS 


OPERATION NAME: No Ch 


tatement. 

LET J:=S 

FOR K:=4 UNTIL 20 

LET BRECK) :2J, J:aJ+S 

NEXT 20 
set of statements would store BR(41)=5, BB(2)=10 


€20)=100. 


ecks Enabled 


MNEMONIC: NOCHECKS 
DESCRIPTION: Gives the programmer the ability to disable time 


critical execution error checksk, This 
statement would typically be the first statement 
"finished known good” program so that the 


in a 


execution averhead of programming checks is 


alley 
unind 


inated (i.e, bounds violations, 


tinlized DR, etc. needn’t be checked), 


"checks" condition is always enabled until 
statement is encountered and then "no checks" 


are d 
EXAMPLE(S): 
> 410 NOCHECKS 
> 20 DE AA,i00 
> 30 LET BB(100):=42 


fee see cone ence 


one until execution is complete. 


(Buffer aren overflow not checked) 


(Bounds and buffer declarations 
not checked) 


The 


this 


AAid~ 
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STATEMENTS - NON~I/0 


POOP SOEF CORE BOF E000 GEOL DERE CFPD ERED 2000 DOSE FOEE OFET CUED OEEE SEOP 2000 SET POOR BEDE SORE 2008 OEE BONE DIET ODDO FET SPOS SORT COTE SEED SOE ONDE HOD BEST HORE FUSE F080 HUES GOSS RIED EFEE EOET EOED HELE ENT FEES FONE HOTT SET FORD ODED OPST HEEE CObe DERE SOR FORE HEEe LEED CON) GEED HERE DEE8 OPED FOND EOOR HENS CDE oDee 


K Tf a catastrophic error occurs in the "no checks" mode 
the results are unpredictable, 


4,24 PAGE 


OPERATION NAME: Page Eject 
MNEMONIC: PAGE 


DESCRIPTION: Issues a page eject to the printer device during 
LISTing. During execution this statement 
executes as a comment. 


EXAMPLE(S): > 400 .END OF SECTION X 
> 440 PAGE 


Mean geek enve h000 scene 


> 420 BEGIN SECTION Y 


net gate c00t cate pete 


> 430 L PRINTER 1007120 


08 sone enne anne se08 


(Listing of Line Printer looks Like the following) 
100 .END OF SECTION xX 


005 Q808 SPEC 2000 8548 GORE OENE SODE ENED E08 2648 FEET SEER 2O8E Send 2086 HEE BEES Ett 3060 cone CEEe 


(Page Eject) 
120 BEGIN SECTION Y 


$006 G00 0006 2062 SNE BORE 2E0e PREM S008 CODE BEDE 0000 DERE DEE HELE BORE SEED CREE GEND COO 2008 


4.25 PAUSE 


OPERATION NAME: Non-Error Pause 
MNEMONIC: PAUSE 


DESCRIPTION: Creates an unconditional pause in the execution 
of the AID user program. This statement is 
suppressed only by the SNPS command, After a 
prompt character (>) is printed on the console 
the operator may enter any valid command, 


EXAMPLE CS): > 40 PAUSE 


Ont onee ence epee 


> 20 RUN 
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STATEMENTS ~ NON~I/0 


G200 Regs OUD GUPe $800 CONS GOED VERE SESS ORES CEES SEED BUEd SETe GEES SEF EERE HOTT BOTS OTST BEES BFEE SECO BEET OEDE COLE DEEL BOLT LOE COLE COd SUDO BERS HERE CONE BEPD RS ODED EOEE BOOT NEG CURE SOND CESe CENT SEDE EEEL OPED BETO ETEE SETO CIES SEED HEED OUND BUDE FORD BED EHNE SEED CDEE SOD CERT GODT StEE DEE DOES HO08 BITE 2008 


>» (Enter any valid command) 


4.26 PPRINT 


OPERATION NAME: Pause Print 
MNEMONIC: PPERINT] €*1 string C3 Cor ,)1] Estring] Cetc,?) 


DESCRIPTION: PPRINT is identical to the PRINT statement 
except after the print a pause occurs. PPRINT 
may be suppressed by SNPR and the pause may be 
suppressed by SNPS. The optional (x) will 
suppress the pause which follows the print. If 
the Reserved Variable STEP is greater than zero 
the message string is preceded by a STEP number 
message (See Reserved Variable STEP), 


EXAMPLE(S) : > 40 LET Ars 


> 20 PPRINT "BAD GUY IN"32;A 


>» 30 RUN 


BAD GUY IN S 


2008 Sent GONE enEe ES 2804 vEDe cEsd s000 sE00 Cot b0ed 


> (pause mode) 

-“ or 
> 10 PPRINT X "TOO LATE NOW! !" .SUPPRESS PAUSE 
>» 20° RUN 


TOO LATE NOW!! 


$000 W900 C000 CoEE PERE COTE CURE SERS LENE SHEE CONE COP COND ORT 


C002 CE8d BUN) Ones GoEE 2000 Coes COeY DERE DEEE NEE BENE HEED ONDE CObE FORE OnEE 8000 COOT Ghee S0Ee SORE CEbe 
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STATEMENTS ~- NON-T/0 


Abel HOS ose S000 CHER HEE CUNS CORE OENE EOE COED SORE BEES SITE CORE CEES SERS SEE FEES DEED DONE DODD CatE TOE EDED CEES FELT HEBD DOLE HEE COUR FEED CFOS BEES ObEE CNET CORE HEEL HOLE CODE EOD Cele MEDS FEED ODE ODEE CONE CRED CODE DEEE SOS SEES CEES SEED OPES SECS POEL SEER COED OTE SNES USER CEES SEED ERE SO0E S000 Sete sone et0e 


4,27 PRINT 


OPERATION NAME: Print te Console without Pause 
MNEMONIC: PREINTI Estring] C3; Cor ,)] {string] etc. 


DESCRIPTION: Enables data, print spacing* or strings to be 
output to the list device. This statement must 
be used to print non- error messages only (see 
EPRINT or PRINTEX for error message reporting). 
This PRINT will only be suppressed by the SNPR 
command. PRINT strings may be concatenated with 
(3) to suppress return~ Line feed or (¢,) which 
generates a return-Linefeed. 


EXAMPLE(S): > 40 PRINT "A"325"BC", "DE"335 "FGH" 
> 20 RUN 
A RC 
DE  FGH 


> 40 DB &AA,10, "ABCDEFG" 


> 20 PRINT &AAC3,6) ;2;4AAC0,2) 


> 30 RUN 
DEFG ABC 
> 30 


* See PRINT SPACING under Special Characters. 


A4iD- 20 


e008 O80e wos Mee Cone ogee GOte Cane SOEs COTS eEEy SHES ceee vane een mene 


4.28 PRINTEX 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLES): 


4.29 RANDOM 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION; 


EXAMPLE(S): 


STATEMENTS ~- NON-I/0 


Gee eee See gees Sone S00 cade CEES Cone erEE SOEr tobe Coes SoEE Oren SOLO Rte SOE BEDE Cone SEET Dene COUR Sony CEES DOSE BEET TEE GEEd SHED USE HOTS HELE SLE GHEE COOL DEEL CONE UE) CEOS HEED BEES DOE SEDE OOEL COND SORE COED EEEE EOUE OOH Ouee SeEe Hoel 


Print Error without Pause 
PRINTEX [string] E€3 Cor ,)] [string] etc, 


PRINTEX is identical to PRINT except that it is 
suppressed by SEPR like EPRINT (see PRINT for 
further details). 


> 40 PRINTEX "ABC"; "DEF "32; "GHI" 


moqe enee vee sng 


> 20 RUN 


ABCDEF GHI 


tere Cree GORD Seee Bebe oEte SEED Sane EEGs Stee cous 


Generate Random Numbers 
RANDOM ECargument)] yvariablei €,variableNn] 


Generates random integers (-37,768 to 32,767) 
from an argument (optional) and stores them into 
the variables specified (Cvariabli to variableN). 
If the arguement is not included the random 
sequence continues normally, otherwise the 
random generator is preset to the argument. The 
random generator will cycle through 128,563 
random numbers. 


> 40 RANDOM(10)A,B 


eee cate ence cee 


> 20 RANDOM(100C,D (NOTE THAT A=C AND B=D SINCE 


> 40 RANDOM A 


een opse wens sone 


~or= 


THE SAME ARGUMENT WAS USED) 


» NO ARGUMENT 
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STATEMENTS - NON-T/0 


9400 OREO BENE GOES FOND E008 REEF COED GEEE OOUT SEED Ont SOO) O60 EDEL COER EEC ENED OFED EEEE CODE DERE Ob08 PONE UOTE OEEE HERE COTE E9OE DORE NEE EONS SORE OOF ONES SHEE CURE GENE DERE EOEE SET BNET EDO) ENDL SEE CRED EEE HERE GOES ONES FO00 DEED CONE EOEE SNE) BFET ONDD SEND GUTD CEES SORE SIE GEO GONE FETE SOLE SEI StEC CRED Leet 


> 40 RANDOMCRUNPARAML) A COPERATOR PASSED AN ARGUMENT 
meee WITH RUN X) 


> 40 RANDOM AACO),F,TIME 

see ane (GENERATE THREE SEQUENTIAL 
RANDOM NUMBERS WITH NO 
INITIAL ARGUMENT) 


4,30 READCLOCK 


OPERATION NAME: Read System Clock Contents 
MNEMONIC: READCLOCK variable 


DESCRIPTION: Reads the contents of a register which contains 
the amount of clock intervals as specified in 
the STARTCLOCK statement (see STARTCLOCK 
Statement). Resolution is restricted to +-95% 
of a clock interval therefore averaging schemes 
should be used for critical timing measurement, 
This statement also stops the system clock from 
further interrupts. ' 


EXAMPLECS) : >? 100 STARTCLOCK 49 -START 10 MILLISECOND 
TIMER 
> 440 RS10 AA »START CHANNEL PROGRAM 
> 420 READCLOCK A »GET 10 MILLISECOND 


INTERVAL. COUNTER VALUE 
SINCE STATEMENT 100 


NOTE: The amount of overhead in executing 
AID statements should be accounted 
for by the programmer. 
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4.34 READFILE 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLECS >): 
> 410 


> 15 


> 20 


eave cove cave sete 


> 30 


STATEMENTS ~ NON~-I/0 


WEee $OSt ODES COED OEE COED NEDO AEDT HEE BIDE LOTT ORT SURE CONE DEED CONE BENE SORE EEE AEDT BEET CORE SOUR ONEE FETE SNE UNOE SBOE ETE COEF GIDE ONE BOSD COED EDO C000 CERT ENED GONE BENT NOOE FORE HOES FONE ODED ERTL E008 Gade SEN) HEE db81 CNET BRET HIOD DOE 


Read File 
READFILE buffer element,length 


Rends data from the file "filename" and stores 
it into memory starting at the location of the 
buffer element for length words(or characters If 
using a atring buffer)kxk, Any file may be 
accessed by this statement. 


DB &AA,7,"HOLDIT " 

DB BB,10 

FILENAME &AACO) 

READFILE BBCO),40 (The first 10 words of the file 
HOLDIT are stored into the 


buffer BE starting at element 
zero) 


Kk A valid FILENAME statement must be executed prior to executing 
this statement, 


XXIf the buffer being written is a string buffer the element is 
rounded down to the nearest even element to maintain even word 


boundaries, 
incremented, 


If a “rounding” is needed the length parameter is 


Example: > 100 READFILE &AACS),5 


wees ener ons 


eese cone 


This statement would read & bytes from HOLDIT and put them into 


&RAAC2), 
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STATEMENTS ~- NON~I/0 


2090 MNED C088 SEE BERD SEES COTE FORD BERT NEE EAND CONS SORE BEEP BOGE COED CORE SO>DE BHEe GOH THEE CERO BCEE DEES TENE COED OEP CORE CEOL DEEN TOR CIEE THEE COND BLE LETT EEUE COLE CREE FOF OEEE SECU GOED COPE CREE C000 SOLE SOLE SHEE DORE SEES SEEN EEDE SEES BEEF OPEE EEE FOOD COED OPED EEE OhED GEEE CONE EOD CODE HEEL SEED SOte Stee 


4,32 RETURN 


OPERATION NAME: Return from Subroutine 
MNEMONIC: RCETURNI 


DESCRIPTION: Causes a transfer of control to the next 
sequential statement after the last GOSUB 
statement executedk. If no GOSUB occurred, 
program execution is aborted with an error 


message, 
EXAMPLECS); 40 GOSUB 60 .GO TO SUBROUTINE STARTING AT 60, 
20 4 s a 


60 LET A:=Ati,B:=B+4 


70 RETURN »RETURNS TO STATEMENT 20 


*xSee the Reserved Variable OFFSET for returns to other statements. 


4.33 SECTION 


OPERATION NAME: Section Execute Test 
MNEMONIC:: SECTION x, label 


DESCRIPTION: When a program is split up into sections the 
SECTION statementk may be used to determine 
whether or not to execute a particular section. 
The executable sections are predefined by the 
TEST command and/or by assigning values to the 
Reserved Variables SECTIONSI/3 (see Reserved 
Varinble section for further details). When a 
SECTION statement is executed the Section x bit 
is extracted from the appropriate bit mask for 
SECTIONSS/3 and if set the next sequential 
statements are executed normally and the 
Reserved Variable SECTION is set to the section 
number. Otherwise, control is transferred to the 
Statement specified in LABEL. 
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STATEMENTS - NON-I/0 


Gres cape cece Gane S00 Rete HOES etee ENTE SaTe OFEP BETS SEED DED HOOD GENE COTS eben EEE TEES ONES Cue SEEE CrED SOEs BEES SEES CURT CUED CORE SEED SEED SEND COTS GREE COED FEI ERbE CEES STE CORE CURE CEES Sete Sere SEED GOED CEne SEES EINES COED GOED COED COND ENED COED GUO Gene ODED ERS end GUNG GOED ORES COPS PbS GETS HEN GETS SUES 


EXAMPLE(S): > £0 SECTION 1, 60 


> So »End of section 1 


> 60 SECTION 2, 120 


> 120 . END OF SECTION 2 


ence cone coves ense sony 


* Do NOT confuse the SECTION statement with the SECTION 
Reserved Variable, 


4.34 SPACE 


OPERATION NAME: Line Space 
MNEMONIC: SPACE (X] 


DESCRIPTION: When listing a program on a printer device, 
generates X line spaces before the next 
statement. During execution this statement is 
treated as a comment. Default X is i space. 


EXAMPLECS) : > 10 .END OF STEP X 


> 20 SPACE 3 


sete ence cece cove 


> 30 BEGIN STEP Y 


> 40 LIST PRINTER 


(listing on the line printer looks like the following 
10 -END OF STEP X 


C00) Gate CCS Dege COPE aeee GOES OURS SEND EbuE OEDe C8Se SERS Sues BEEP CenD Cece CO cont 


(3 Line Spaces) 
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STATEMENTS ~ NON-1/0 


C0Us 0008 C008 CORE EGRD eee ON) Sent OME ‘ovae soe 0000 ons Snbb nosh SOY S908 Gndh S006 GO0R'suet HONE sete O7ON boar eB SEED SYNE HERE SOLE FONE SUN SE0E GONE OLED NEE GFEE GOOD Gate BEES OOD DOEE OEEE EDT GORE HOSE ONC O10 OUND One” SEnD OH0C QOER SOE OOEN COND GOEL 8=tO OMe DEED enn GOED G460 BEE SUNS SUT DNee HERE sume ante onne 


30 \BEGIN STEP Y 


‘EM CRD GHG MESO CAR COGS COTE SHEE OFT HENS Sone SOE baOd GAG) HERE GREG Este FORE 


4.35 SPACESOFF/SPACESON 


OPERATION NAME: Control Numeric Print (with/without leading spaces) 
MNEMONIC: SPACESOFF /SPACESON 


DESCRIPTION: Allows the programmer to print numbers right 
juetifiled with leading spaces(SPACESON). The 
default condition is no leading spaces until a 
SPACESON is executed. SPACESOFF disables leading 
spaces print, 


Note: Hex numbers occupy S digits 
Octal numbers occupy 7 digits 
Decimal numbers occupy 6 digits 


EXAMPLE(S): > 40 LET Al=!FDF,B:=%7657,C1=4839 


> 20 PRINT !A;Z483C ‘LEFT JUSTIFIED 


eum ete gon oree 


> 30 SPACESON 


>» 40 PRINT !A3;4B;C -RIGHT JUSTIFIED 

> 50 SPACESOFF “RETURN TO LEFT JUSTIFIED 
> 60 RUN 

1FDF%76574839 


'FDF 247657 4839 


Note: If ZEROESON and SPACESON ore both enabled then 
ZEROESON is dominant 
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4,36 STARTCLOCK 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLE CS): 


STATEMENTS - NON~I/0 


Start System Clock 
STARTCLOCK Cinterval in milliseconds] 


Initiates operation of the system clock and causes 

a counter increment every interval as specified in 
the optional parameter (default is 1 millisecond). 
The resolution of the clock is +-952% of the interval 
specified, 


»1400 STARTCLOCK »START £1 MILLISECOND TIMER 


4.37 SUPPRESS 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


4.38 WRITEFILE 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


100 STARTCLOCK i .START 4 MILLISECOND TIMER 


Suppress Errors 
SUPPRESS 


Resets the ENABLE statement override flag thus 
returning to conditions set by the error 
printing commands, See ENABLE statement. 


Write File 
WRITEFILE buffer element, length 


Writes data starting at the element of the 
specified buffer into the file “filename“X for 
length words (or characters if using a string 
buffer )*k, Only DATA and SPLII files may be 
written into by this statement. (See the 
Diagnostic/Utility System ERS for further 
information) 
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STATEMENTS - NON-I/0 


2000 ON0G GORF GEER 0900 S008 REID FIND BOLE FETE HEED COUN O00 HEPD OESE UNDE EDT) SEHD GOOD SETS FUDD St00 BODE CESS ELE SEES SUOE S0GE GEES CRED COUT SORT SEED DETE COE FOOD FETE EEDD COED SOb2 CEDE SOD GEST FEED FETE CITE SEES DEED SHE COTE SEET BGIE HEM TNS OTNF OOD KITS CECE OREO OODF NER GREE SOME HOES CIEE OES SOOE DéED COED eee 


EXAMPLE (S): > 40 DB &AA,6,"HOLDI " 
> 15 DB BB,200 
> 20 FILENAME &AACO) 


> 30 WRITEFILE BRC100),20 
<0 no te (Writes data starting at BBCi00) 
into the file HOLDi for 20 words) 


KX A valid FILENAME statement must be executed prior to executing 
this statement. 


aXIf the buffer -being written is a string buffer the element is 
rounded down to the nearest even element to maintain even word 
boundaries, If “rounding” is needed the length parameter is 
incremented. 


Example: > 400 WRITEFILE &AAC3),HOLD1,5 


(et veee cues aro once 


This statement would write 6 bytes inte HOLDi starting at 
&AAC2Z)., 


4,39 ZEROESOFF/ZEROESON 


OPERATION NAME: Control Numeric Print (with/without leading 
zeroes) 


MNEMONIC: ZERGESOFF /ZEROESON 


DESCRIPTION: Allows the programmer to print numbers right 
justified with leading zeroes (ZEROESON). The 
default condition is no leading zeroes until a 
ZEROESON is executed. ZEROESOFF disables leading 
zeroes print, 


Note: Hex numbers occupy S digits 
Qetal numbers occupy 7 digits 
Decimal numbers occupy 6 digits 


EXAMPLE (CS); > 40 LET A:=!FDF,B:=%7657 ,C:=4839 


> 20 PRINT !A;Z%B;C LEFT JUSTIFIED 


eave 4ete nee sage 


> 30 ZEROESON 


cece eee coe epee 


> 40 PRINT !A3;%8;C »RIGHT JUSTIFIED 


(904 core cane eons 
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STATEMENTS - NON-I/0 


> 50 ZEROESOFF »RETURN TO LEFT JUSTIFIED 
> 60 RUN 


'FDFX76574839 
'GF DF 4007657004839 


Note: If ZEROESON and SPACESON are both enabled then ZEROESON 
is dominant. 


44iD~ 29 


5.0 


The AID Special Characters are listed, 


section. 
OPERATION NAME: 
SYMBOL: 


DESCRIPTION: 


EXAMPLE CS): 


S.i4 6 


(Period) 


OPERATION NAME: 
SYMBOL. : 


DESCRIPTION: 


$.2@ CONTROL H 


OPERATION NAME: 
SYMBOL. ; 
DESCRIPTION: 


EXAMPLE(S): 


SPECIAL CHARACTERS 


COCs EAD OFNE DEES CURE StED SEE GNSS REDE COPS Cane HEDO DODD SERS SNES CEES SEE SEES SEte SEES BYUT SOUS SEES EENh FONT CONE GED SEDE SEEN ENTE SENT CIOL SUNG SEDE GDED TEED CORD Cpne UNE ODE C000 CEES SEND SUtS CUDY teen Sate EERE CEES COED OEM SUED Ese Gtyn 


SPECTAL CHARACTERS 


in detail, in this 


The format for each Special Character explanation is: 


General phrase of what the Character does. 
The Special Character. 


A detailed explanation of the Special 
Character’s function. 


One or more examples using the Special 
Character. 


Comment Identifier 
(Period) 


See the description under Comment in the 
Statement Section. 


Backspace (one character) 
CONTROL H (Bs) or BACKSPACE 


Allows the operator to backspace to the last 
Console character by pressing the Control and H 
keys simultaneously on the Console. The cursor 
is relocated to the last character input and 
that character is deleted. 


CRT Example 


9000 Ovet seen Gene ep9e 800s DECe CORE eeeT Sens OtED 


> 10 LES 


(S$ is incorrect, Operator presses CONTROL H) 
> 40 Le 


APR 10, 1979 44iE- if 


SPECIAL CHARACTERS 


0082 2000 BORE GEES ACES OOSS ORDE COTE GEOL COED OLED COLE NEED ODED COTP GORD COLD SESE SUED OSES BODY OODD COED CRY CODD SIRT GEES SETE SEED ONES SDE SEDE COED O40) GIES CODE HOOD SREY LOE CODE CORD CREE IEEE SOEE GEE COED HOOD FORE BODE 2000 HEED FETE EES SEE SEED OES HEDE S98E OOES SED ECON BETO CORE CEES CIES SEED COE HOEY StCt eseD 


cee cove eves eve om 


5.3 CONTROL X 


OPERATION NAME: Delete Existing Line Input 
SYMBOL: CONTROL X(CN) or DELETE ENTRY 


DESCRIPTION: Allows the operator to delete the existing input 
character string by pressing Control and X 
simultaneously on the Console. Three 
exclamation marks C!!!) and a return-line feed 
are printedk and the operator may input a new 
string of characters. 


EXAMPLECS): > 10 LET Xe !!! (No input occurs) 
26,7Acl!! (Deletes all inputs) 
K Note~ !1! may not be displayed on some Console types. 


5.4 () Parentheses 


OPERATION NAME: Enclose 
SYMBOL: () Parentheses 
DESCRIPTION: Used to: 


~-~Enclose a buffer element 
~~Enclose a special optional parameter 


EXAMPLE(S): 


> 40 LET AAC2Z);=2 DEFINES ELEMENT 2 OF AA 


444E- 2 t444e00p t4442e02 


SPECTAL CHARACTERS 


cee Ones SEES tgee eee BEES eOEe BETD BEET SEY OECD HOPE SETS OUER SORE FEED SEED H9ES EEE FOES CDSS FORD DEED SOE OEE Cota DEE CORD SEbE CHER SOY SHEE FETE EOE CEES GOLD SEES ABET CRED FFTT CEES GLEE SESE DEO FOES DEED SHED OOE0 BEES YOTE CHES Cope BEUE SORT SUNT ORES SEES SEES SOpE SETH VOSS OtES UEtE OUEE OEEE OLN) GoEe MEGS CoES done 


> 20 LET &ABBC2):="H" .DEFINES BYTE 2 OF ABB 

> 30 PRINT “¢2)>" »PARENTHESES ARE ASCII CHARACTERS ONLY 
> 40 RANDOMCX) A »-ENCLOSES OPTIONAL ARGUMENT 

5.5 " " (Quotation Marks) 


OPERATION NAME: Enclose a Character String 


SYMBOL : *" " (Quotation Marks) 

DESCRIPTION: Encloses a string of characters for assignment or 
printing, 

EXAMPLE(S): 


> 40 LET &AACK):="4" (SET THE RIGHT BYTE 

ae OF WORD £1 OF &AA TO AN ASCII 
CHARACTER 4) 

> 20 LET &400¢10,44):="HELLO" 

Seas (STARTING AT CHARACTER 40 
OF &CC STORE THE ASCIT 
CHARACTERS HELIO SEQUENTIALLY) 


> 30 PRINT "OK" »PRINTS OK ON THE CONSOLE. 
KNote: Quotation marks inside a string are not allowed, 
S.6 ! CExclamation Mark) 


OPERATION NAME: Hexadecimal Notation 

SYMBOL : ' (Exclamation Mark) 

DESCRIPTION: — Denotes the following variable, mumeric or buffer 
element will be referenced or manipulated as a 


hexadecimal based number. 


EXAMPLECS): 


> 40 PRINT !G6 “PRINT THE VALUE OF G IN HEXADECIMAL. 
> 20 PRINT "lA" »DENOTES AN ASCIT !A ONLY. 
> 30 LET A:=IF »A=HEXADECTIMAL F 


44iE- 3 


SPECTAL CHARACTERS 


00 9OOb OPED HEED OEE BERD HOSE C808 ONES EOEE SEND OREN CNEH BEES SEED EERE LAGU S900 OEE LOSE S0EE BEER OOD STE C600 OObS ETRY COEE BADD CONS BEES OEET 9005 CDTT SEED BODE COED SEDD OBY FEET FORE EER OID DEED FEE FEF COED COUP OLDE FETE SEED GORE SORE HOES GORE SORE HORT EEEE BYES FOND SEED SEER SEP FEET OORT DEED 0En SER ON68 OREO 


toee wore cone eene 


5.7 %& (Per Cent Sign) 


OPERATION NAME: Octal Notation 
SYMBOL : — -% (Per Cent Sign) 


DESCRIPTION: If the symbol (Z%) is not contained in a character 
string, it denotes the variable, numeric or buffer 
element following it is represented or manipulated 
as an ectal based number. 


EXAMPLE (CS): > 40 PRINT 4G «PRINT THE VALUE OF G@ IN OCTAL 
> 20 PRINT "ZA" »DENOTES AN ASCII CHARACTER ZA O 
> 30 LET A:=437 AZOCTAL 37 


5.8 Print Spacing 


OPERATION NAME: Print Spacing 
SYMBOL : 0 through 79 


DESCRIPTION: Provides print spacing when concatenating strings 
in print statements. 


EXAMPLE CS) s 


>» 410 PRINT 8; “EIGHT” . PRINTS 8 SPACES AND THEN "EIGHT" 


> 20 PRINT “BIG";15; "GAP" 
vom »PRINTS BIG, 15 SPACES AND THEN 
, GAP 


AME- 4 


SPECTAL CHARACTERS 


00S CORE COST OUTS ETT GENE CEE CPEP COED COTE SOUT GOOE BEET CEP GOES COET BNET SETS CES GEES CONE COTE SUSE SOY ENTD OOED ETRE SOOO FEO SEES CUTE ORE CONS COLE SPE CODE SEED CONE SUUE SOEE GOUT BED EDEE ENDS GIES CONT SORE DORE CODD OEE CORE EOE) GREE CUED OOEL EFCE BhE CONT SOS Fede COtD SETS SEEN anNE SOtn Emne BOTT BORE ahEY tote 


S.9 > (Greater Than Sign) 
OPERATION NAME: Prompt Character 
SYMBOL: » (Greater Than Sign) 


DESCRIPTION: When AID or an executing program expects a Console 
input, the prompt character (>) will be printed in t 
first line space (See the operators section for a 
description of the "greater than" function). 


EXAMPLE CS): > 400 RUN 


CATTENTION) 
Break in Statement $0 


C000 Gene OOS O00y BON FOES SORE O008 OURE EEE SET CEES HERE Cote BETS SEED SaBT Gute Cebe pene eete 


> (CAID IS NOW AWAITING OPERATOR INPUT) 


$.40 & (Ampersand) 


OPERATION NAME: String Buffer Designtion 
SYMBOL : & (Ampersand) 


DESCRIPTION: Denotes a string buffer, This Special Character 
is not allowed anywhere else (except inside a 
character string). 


EXAMPLES): 


> 140 DB &AA,1i0 . DEFINES &AA AS A 10 CHARACTER STRING BUFFER 


aren cece eves gues 


> 20 INPUT &AAC2Z,4) JACCEPTS 3 ASCII CHARACTERS 


> 30 LET &As="HI" NOT ALLOWED. VARIABLES CANNOT BE USED 


>» 40 LET &AA:="HI" (NOT ALLOWED. STRING LENGTH 
ee eae MUST EQUAL ELEMENT COUNT) 
> 45 LET &AACO,4):="HI" (ALLOWED. ELEMENT COUNT 
EQUALS STRING LENGTH) 
> SO PRINT "&"3A »SPECIFIES AN ASCII & WILL BE PRINTED 


0OP oese ones veee 


44iE- & 


SPECTAL CHARACTERS 


100 FORD PONS SORE CEES OORT SORE FOND OFEE BEGH LETD SEED ONE ontE BEES SEES OO0E GERD SERE CELE CEES FETE CODD CECE SPEE COTE BEDE CODE BODE SURE SORE HENS EOEE SERS OND DODD ODOT OUST CORD FE5E wELE HOE STED OLY GOE0 DEFT BEES OBES SURE SERS DERE FORD BEET OIE SEEE DEE COEE DUDE BEES Sue BEDE OPTD cone GONE FOOd SHEL COED Bees HEED Cott 


5.41 3 (semi-colon) 
OPERATION NAME: Suppress Return-Line Feed 
SYMBOL: 3 (semi-colon) 


DESCRIPTION: If the symbol ¢€;) is contained in a concatenated 
print string, it denotes no return-line feed is 
desired after the print operation. A comma is 
used to force a return-line feed (see comma 
Special Character). 


EXAMPLE CS > : > §S LET A:=S 
> 40 PRINT A; »PRINTS S ON THE CONSOLE. 
aia THE NEXT PRINT WILL CONTINU 
FOLLOWING THE S. 

> 20 PRINT A;" DAYS" “PRINT S DAYS ON THE CONSOLE 
aia WITH A RETURN-LINE FEED 

> 30 PRINT "CALL " ;A PRINT CALL S ON THE CONSOLE 
sm coe WITH A RETURN-LINE FEED 

> 40 PRINT "3" »PRINTS A SEMI-COLON ON THE 


oueDieas CONSOLE 
> SO PRINT A353;A3;4;A,A53554 


> 60 RUN 
S5 DAYS (statement 10 and 20) 
CALL S (statement 30) 


} (statement 40) 
5 5 5 (statement SO) 
5 


S.42 Control Y Attention 


OPERATION NAME: Suspend Execution 

SYMBOL. : Control YCEm) or ATTENTION 

DESCRIPTION: During execution of a program or command, the, 
operator may interrupt and suspend execution by 
pressing control and Y simultaneously Cor 


ATTENTION). The prompt character (>) is printed 
to indicate AID is awaiting operator input. 


EXAMPLECS): ; 


> 400 RUN 
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Oeep ston eres Enee Sbse OTe Bebe Stee Sete Gees Cree Ones ObEe eEES BEES EEE 


S.43 2? or ?? 
OPERATION NAME: 
SYMBOL : 


DESCRIPTION: 


EXAMPLECS): 


SPECTAL CHARACTERS 


Cee poee Gee SESE ones HEEE COEE SEES SbEE BEES BEET NRE Shes CoS Shte BrES eUIY OTE EDEL BEES BEEE DEES CED Bebe NEES SESE tebe TORS CUES OEE FIED DELS OPES BORE SOLE SoEE SOte BEDS BEES CUES FEED SOND OOIE BEES Stne OGD OPES Snes REDE OVES eREE CORE etED rest 


See e00s Cene ese voce 


(The AID program is now executing.) 


CTRL Y (Operator presses Control and Y) 


Cond Cn8e 000 Hane SOEs DAES SEEN Ouse CUES COEY DEED BEEE DANE HHEe SEH CECE HEE Cone HOUE enED SONS 


Input Expected 
? or ?? 


A question mark ¢€?7) indicates the executing 
program expects an operator input. A double 
question mark (72?) indicates the operator did 
not input sufficient information (i.e. more 
input is expected), 


> 40 PRINT “ITNPUT" 


ate exes 2000 enee 


> 20 INPUT A,B,C 


enee anes oes wees 


> 30 PRINT A323;B3;2;C 


> 40 RUN 


INPUT 


sees ease vows cess cece 


? 3,6 
2? 8 


5 6 8 


tee eoee tren cose one cose ated 
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SPECTAL CHARACTERS 


2008 C064 6008 CONE GEES SUH C008 BEEP COEE 2008 CEES SEOE E000 SEED BEES OYEE FORE SED 8660 SDOE SOOO FOND OLE TROT CULE DUES BEDE T50E BODE GEOP CODE 8008 SHEE F060 ORO BEET GEER BOLE EEE TIDE COE 90E0 BOLE 2900 GOOE LOTT 4600 ULE DEER COLE SED ITP O40 GEOT 2EED GOED EEIO 2000 COOL SOUR 088 Fes ODED O080 ODEL 0600 COE Cone ett CpEE 


5.44 , (Comma) 


OPERATION NAME: Separation of Expressions or Force Return-Line Feed 
SYMBOL: (Comma) 


DESCRIPTION: Comma (,) may be used to separate expressions; to 
force a return~line feed in concatenated print strin 
(see semi-colon Special Character for suppressing 
return-line feed); during command and statement 
input to separate parameters, and during 
INPUT execution to delimit individual inputs, 


EXAMPLEECS) : 


> 4140 LET Ai=4, BisS ‘COMMA SEPARATES EXPRESSIONS 

> 20 PRINT A,B “FORCE RETURN-LINE FEED 

> 30 PRINT "," “DESIGNATES AN ASCIT COMMA ONLY 
> 40 RUN 

4 

'5 

U 

> 40 RUN 1,2,3 | (COMMAS SEPARATE RUN PARAMETERS) 


> 40 INPUT A,B,C 


dene erne e0ee eee 


>» 20 RUN 


e009 soe ease sone 


?7 1,2,3 (COMMAS SEPARATE INPUT VALUES) 
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SPECIAL CHARACTERS 


C0nn sane 0480 Enns GOSS O9Ne HELE HERE COND SNGH FEES OREN FORD FEEL G00b CEDE BUND SOE GONE S008 BORN S660 C054 SEES SETS HEED Lode GEES ONES BEET CORE OEEE OURS BEE BODE EES BEDE E604 SOFL GOne SO8D GADD COEF GOED SOD GEDE SUTE EFEE ERE SOOE ENDL OEE DIET CORE ENO EEN OTEE SOUL GOED HOOD BEE COND OUND Eby ONG SONS REET MNES SHEE OOOO 


S$.45 / (slash) 


OPERATION NAME: Inclusion 
SYMBOL: / (slash) 
DESCRIPTION: Allows the operator to enter multiple numbers 


X/Y meaning X through Y inclugaive (also see the 
Divide Special Character), 


EXAMPLECS) : 

> 400 LIST 407/750 (list statement 410 through 50) 

> 400 b20/50 (delete statement 20 through 50) 
» TEST 1/3 (initialize test of Sections i 


through 3) 


S.46 CTRL-Shift 


OPERATION NAME: Interrupt output on IDS 


DESCRIPTION: If using the IDS as console, hold down CTRL and 
Shift keys simultaneously to temporarily interrupt 
the Listing. It will resume when you release 
the keys. This is an IDS firwore feature; it is noti 


provided by the AID interpreter. H 
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eee cues cape stae Sey sane cone cose 2009 SOs SEEy CEES Sony See tune sere 


6.0 OPERATORS 


this section, 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLECS);: 


&.4 {= 


OPERATION NAME: 


SYMBOL: 


DESCRIPTION: 


EXAMPLECS): 


IPERATION NAME: 


SYMBOL: 


ESCRIPTION: 


OPERATORS 


Coes Sete COPY OPES O4ER CuEd Cane OURS RIES BODE S400 CONE OFEY HORE HOES BEY BORE CONS AOD BERD Cone OLE TROT S080 HOES GURL MUS Cord SEED ETEE FEDS BEES COED BEET SEBS SUED UES Sone G00s Goes ONES ONDE SEED SEND COMD Sten SUES Sars CEES UIEL CERT FUER Cute eWEe 


~ The Operators available to the programmer are listed in detail in 
The format for each Operator explanation is: 


General phrase of what the Operator does. 
The form that the Gperator would be used in. 


A detailed explanation of the Operator’s 
function, 


One or more examples using the Operator. 


Assignment 


to 


Assigns the value of an expression to a variable 
or buffer (see the LET statement for further 
examples and explanation). 


> 40 LET A:=2kB+4 

> 20 LET &AACO,5):="HELLO!"  (A&AACO)SH 

aoe AAACL)SE, 
&AACZ)EL, ETC.) 

> 30 LET BB(4):=!F .BB(4)=HEXADECIMAL F 


Single Word Integer Multiply 


x 


Executes an integer multiply on two values. The 
multiplication product is limited to the range 
of a single word integer (i.e. = ~-32,768 to 
32,767). Integer overflow during execution will 
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OPERATORS 


OWUE TOOT AONE O8OR EEO 4008 F008 DGD BEN HOHE 4000 4007 SAND 66UR EbES C008 


EXAMPLE CS) : 


6.3 / 


OPERATION NAME: 
SYMBOL: 
DESCRIPTION: 


EXAMPLE(S): 


6.4 + 


OPERATION NAME: 
SYMBOL : 
DESCRIPTION: 


EXAMPLE CS); 
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6065 GERD CONG 6068 GERD GOED S508 GONE DIGE BOD CEOE BORD 0560 GOLE SEND SOE ENEE 2440 2800 SOLE SOUT 8498 440 COED BOE SUED 608 4608 BEID AFD UES ONDE 0600 OEE COE GOES CEES 5400 BUDE FETE HOOD COE BOSE Shen GEOL $505 1068 E9EE GIED CORE SE6t BONA cnet out 


cause an abort with an error message. 


> 40 LET Bi=2 
> 20 LET Al=Bx20000 WILL RESULT IN AN OVERFLOW, 
> 30 LET A:=Bx2 A= 4 


Single Word Integer Divide 
/ 


Executes a single word integer divide on two 
single integers. To access the remainder from 
the divide, the MOD Operator may be used. 
Divide by zero during execution will cause an 
abort and an error message (see the special 
inclusion charnocter (/) also). 


> 10 LET A:=4,Bi=4i 
> 20 LET C:=B/A C=2 QUOTIENT 
> 30 »D=3 REMAINDER 


LET D:=B MOD A 


cure aeee coun eens 


Single Word Integer Addition 


+ 


Adds two single word integers and provides a 
Single word result. Qverflow (Sum)32767 or 
Sum<~32768) during execution will result in an 
error message and will abort the program. 


> 40 


ener enve cone ance 


> 20 


one enee seme cate 


LET A:=10, B:=30 
LET C:=A + B .C = 49 


t444F00p 


((0ed etd ORR) COED GOES Cote pErD GEES SEED eute G0gT anne Senn ease epee Gn0e 


6,5 - 
OPERATION NAME: 
SYMBOL. ; 
DESCRIPTION: 


EXAMPLE CS) : 


6.6 NOT 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLECS): 


6.7 & 
OPERATION NAME: 
SYMBOL ; 
DESCRIPTION: 


EXAMPLES): 


OPERATORS 


Geet 068 0000 GOES OOD GORE ONE C000 EEDD AteH GORD COLD SEES LENS GOED GUE SETS SEED SON TEE GUD SO6ID GO0D 4NES Gude EEGD EOE LORD SEED COND OEE HERD NTE EDEL AITT ODED SEED OED G10 LODE SOD SERS SEtY CERN SEED OGte ONES EES GONE COND Cnet one GEN Ot0e 


Single word integer subtraction 


Subtracts two single word integers and yields a 
single word result. Overflow (Difference >32767 
or Difference<-32768) during execution will 
result in an error message and program abort, 


> 40 LET A:=4 


» 20 


> 30 


LET Br=10 


LET C:sA~B C26 


Ones Complement 


NOT 


Executes ones complement arithmetic on a 
value (all zeroes to ones, all ones to 


zeroes), 
> 40 LET A:=-4 »A=-£ OR TRUEX 
> 20 LET B:=NOT A :B=Q OR FALSEX 


x Any nonzero number is true and zero is false. 


Equal to 


Provides a relational test between two values. 
No assignment is made. 


> 10 


IF & = B THEN 20 (GO TO 20 IF A=B) 
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OPERATORS 


1505 CEO O880 COED HOOP EFT GE6P C400 GEES CRED UOTE OLED BETS WINS GERD SOUP SLED HESS SEES SURE CERO COLE O0ES BONE GOET BEA ODED BORE TURE SOUP CORD GOOE DEBE BEND DOPE BEDE BOTS URED FORD CLUE BOGE BEET COIN PERT FONE EEE COND BERD ERED HEED S0EF WEED FUND CODE ELD SOED CODY FEET DEEP SUED FEED COOL SEND CORE REED SUDO GOES VObe OREO BEET 


> 20 LET A:=B=C (A IS SET TO -i IF B IS EQUAL TOC 
Sacer ELSE A IS SET TO 0) 


6.8 {> 


OPERATION NAME: Not Equal to 


SYMBOL : <> 
DESCRIPTION: Provides an equality test between two values. 
EXAMPLE(S): 


> 40 IF A <> B THEN 20 .GO TO 20 IF A DOESN’T EQUAL B. 


siiee Ce owen see 


> 45 .A AND B ARE UNALTERED. 
> 20 LET C:=AC>B .C IS SET TO -4 IF AC>B OR O IF 
anne A=B. 


6.9 ¢€ OR > OR (= OR >= 


OPERATION NAME: Greater or Less Than 


MNEMONIC: { or >) or <= or >= 

DESCRIPTION: Provides a relational test between two values. No 
assignment is made. 

EXAMPLECS): 

> 40 jIF ADB THEN 206 -IF A IS GREATER THAN BUT NOT 

so anes EQUAL TO B 

> 45 »THEN 20. 

> 20 IF A<=B THEN 40 .IF A IS LESS THAN OR EQUAL TO 

vm en os B THEN 40 

> 30 LET A:=BCC sA=—-4 IF B IS LESS 


silo dee THAN C ELSE A =0 
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eene Ores Gets ange SESE CUED ENRe Cuee Oe GOES cuse eRES EIGS Cteb Sone Stee 


OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 


EXAMPLE(S): 


6.4% OR 


QOPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLECS): 


OPERATORS 


ewes care C0er Sate cen cote cone SOCt CORS SEEE SEED CEEE SOUS OEED BEES EOE Cote Cqte ERED ORDL SUES SEE EFED SOUR DORE SESS GEL EOTS SIGS ORES Stn SERS SETS FEDS GuEs SERS GHEE CURE EEEE Cnte SOEE Sen SOP CONS HERE Cans CURD SEES SOmN boRE HUN BEeY eryE Feet 


Logical And 
AND 
Provides a Logical AND of two valves. 


> 10 LET A:=!C7 


> 15 LET B:=!BS 


wee ones seee anes 


> 20 LET C:=A AND B C2185 


eo0e wees weer snes 


> 30 IF A AND B THEN 20 
ee (A AND B ARE ANDED AS '85 THEN 
TESTED FOR TRUTH (NON-ZERO) > 


Logical OR 
OR 
Provides a Logical OR of two values. 


> 10 LET A:=!C7 


wen wove eves cece 


> 45 LET B:=!B5 


mace eove C00 cone 


> 20 LET Ci=A OR B CHlr?7 


ene cess bree cose 


> 30 IF A OR B THEN 20 .A AND B ARE OR-ED AS !F7 TH 
amar a »TESTED FOR TRUTH (NON-ZERO) 
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OPERATORS 


6.12 XOR 


OPERATION NAME: Exclusive Or 


MNEMONIC: XOR 
DESCRIPTION: Provides a Logical Exclusive OR of two values, 
EXAMPLE(S): 


> 40 LET A:#!C7 


> 20 LET Bi=a!tBs 


> 30 LET CisA XOR B C=172 


> 40 <IF A XOR B THEN 20.A AND B ARE XOR-ED AS !72 


ave ats cows ert 


»THEN TESTED FOR TRUTH (non-zero) 


6.43 MOD 


OPERATION NAME: Modulo Operation 


MNEMONIC: MOD 

DESCRIPTION: Provides a means of determining the remainder 
of a division process. 

EXAMPLE (S): > 10 LET A:=10 
> 20 LET B:=A MOD 3 .B=4 


tse one gene cece 


6,44 LSL or LSR 


OPERATION NAME: Logical Shift 


MNEMONIC: LSt x or LSR x 


DESCRIPTION: Logically shifts a value x places where x may be 
any value. A logical shift corresponds to a 
logical divide(LSR) or a logical multiply (LSL). 


MA4iF- 6 


OPERATORS 


F008 GORE GORE SOE2 BEDS SRE0 Sone HEED ONEE COE SEDE COLE NEED HELE FEED SHG CIEE SUNS HOOT HORE DORE ERNE CORD OfEe BIND 8DEE GONE SEND OER CRU0 NODE HON CHE Cee WIGS HERD NORD HERE OEET COTE SON TOEd BEGe CRED COE Gaby SEED DEED OITA DEP Suna HOSS Obed FeED ENED SEED S000 SENT GNSS GETe COED BETS Cine DEBT TED DED ante NODS band Goan 


Bits { All 46 bite | 
(eis eiinfap menial nates ' tm (um QO%@ In LSL. 
Lost i ehifted left | 
© cass cree esse sone secs suns tun 0000 9060 soma Seve suse ene suse seen > 
| All 46 bit ' Bite 
O?s In--)--~} fc ete se > LER 


i shifted right | Lost 
> 


EXAMPLE(S): 

> 40 LET A:#A LSR 2 Shift A logically 2 places right 
» 20 LET BireC LSL f Shift C logically 4 place left, 

) 30 LET Ci:=S LSL A Shift S logically (A) places left 


6.15 ASL or ASR 


OPERATION NAME: Arithmetic Shift 
MNEMONIC: ASL x or ASR x 


DESCRIPTION: Arithmetically shifts an integer value x places 
where x may be any value. An arithmetic shift 
corresponds to an integer divideCASR) or an 
integer multiply(ASL). 


Bits Lost 
< Sort gene chee eee nero Ste SORe. owe eer Seen, one ors Seen ene" oeen eee eee ‘ 
H 
H i 45 bits shifted H 0’s IN ASL 
Sign i Letts eae ees 
Unchanged} H Left H 
| case exes 2000 sees voce om sane cost teen Sete sven eons Cede cand ense SOND G00 BOE HOMO aten anen cose Fens Gene ? 
i i iS bits shifted i Bits Lost 
i ok ft RI aaah > ASR 
H H Right H 


K Copy Sign bit x times. 
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OPERATORS 


sat9 (100 PONE OOLD GOED HERD CIDE COTS DEED CuED BEES GREE LED CREE OOD CUED SORE CREE DERE SELT FEED COUT AEDS BRED GHEE BUDE DONS CONE OFDE OLED COLE SEE ERY BLE BETO ODUT SOD BORD SdOL FOES SEC0 DURE FEED BEE URE DEE BERT SOUS SECS GORE SEES SENT ERDE CORD FEDY OFER OUEE ORE YERD S00 COS HONE EtES Ord CONE HOE HEN HOTT CeCe SENH 


EXAMPLE(S): 

> 40 LET A:=A ASL 2 Shift A arithmetically 2 places 
> 20 LET B:=C ASR i Shift C arithmetically i place 
> 30 LET C:=*S5 ASL A oe arithmetically (CA) 


Sas ae places left. 


6.46 CSL or CSR 


OPERATION NAME: Circular Shift 
MNEMONIC: CSL x or CSR x 


DESCRIPTION: Executes a Circular Shift on an integer value x 
places where x may be any value. 


9292 90d AO0e SEN SOEe GaEe SEND ceDE CREE Gen, ExED COED COND B00 COED CTEe 


i All 16 bits | 
i t Shifted left { { 
H % seca sovm snes cnet coey ate suze ewes eoee sees eves vane bees sete cee sees r : 
© case seve coun se0t ceen se snee wens come secs ater > ste nase een aeee cove wots secs s600 cove snee ? 
H All 16 bits |} 
H : shifted right { | 
; S seo wine seem 000 eave ovee seve eum sone sete tees rene tote oben sean sete é : 
© cane move sass este 007 S000 sett wese coun epee sane nor ore cvte so cate ence cate seen sve ance ? 
EXAMPLE(S): 
> 40 LET A:=A CSL 8 -Circular Shift A 8 places left. 
> 20 LET B:=C CSR i Circular shift C 4 place right. 
> 30 LET C:=S CSR A Circular shift 5S (CA) places right 
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OPERATORS 


BOws COOP DENN SOee MASE SHEE BOTS SERS SED COE EEE S000 TOES ECs Gree WEES SEEE FEE SETS CEE O0EE BEDE Cone SNOT EEE UOTE ENDL I6eE SLOT CORO SEED SEN0 SERS CuDE DEED SOLE EOEE COLE BEET BEES FOES DERE EOVE EOL SORE SEES HEE? HAD) POLE DEED DOLE LEOD CFED DEEL OLEe WORT FOLD OUhS EOE Noms FOO) DEER Cote SETS EOE BORE HONE aneE SnTe Sone 


6.47 SGpecial Relational Operators 


OPERATION NAME: Special Relational Operators 


MNEMONIC: NE (Not Equal), ESQ (Equal Tod, LT (Less Than), 
GT (Greater Than), LE (Less Than or Equal To), 
GE (Greater Than or Equal To) 


DESCRIPTION: These special operators may be used only in the 
IF~THEN and IFN-THEN statements, The operators 
NE, EQ, LT, GT, LE and GE may be used to 
logically AND up to three expressions which 
determine whether a branch should occur to the 
"THEN" statement, Evaluation of the "IF" 
expressions occurs left to right. 


EXAMPLECS): 


> 40 IF SLY ALT 40 THEN i506 

oe oe (This statement is evalunted as: 
IF ¢S¢A) AND (A¢410) THEN GO TO 
STATEMENT 450) 

> SO IF A:=R MOD 200 LT 0 THEN 60 

ea (This statement says: 
IF (A:=R MOD 200)¢0 
THEN 60). 
Note that A is not stored with 
a relational result (see next 
example). 


> 70 %&IF A:=R MOD 200¢0 THEN 50 
eee (This statement would store A with 
a True or False value R MOD 200¢0) 


FOR MORE EXAMPLES SEE THE "IF" STATEMENT. 
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RESERVED VARTABLES 


9000 S068 SOND URES BERT BONE G80T NOES GORO NEDT ORDY DOEE DERD OENE FO GER HORE GOTT HORE ROOD HERE HEDD EETE GENE ROG? GODT DERE SORE TERE RES BENT ONEE CREE SEPT GENE COLD GORE BODE BEDE SED LOE SIDE DADE OFOE THOU DEAD SODE GEES DEEL 4dte bts Cate DEEL DOOD OOEE SOD LEED GED HORE LORE Bdde 900 BORE ON! G04) OPED DENY FORE DOES Fee 


7.0 RESERVED VARTABLES 


The Reserved Variables available to the operator are Listed in 
detail in this section. The format for ench Reserved Varinble 
explanation is: 


OPERATION NAME: General phrase of what the Reserved Varinble 
Means. 


MNEMONIC: The form that the Reserved Variable would be 
called in. 
DESCRIPTION; A detailed explanation of the Reserved 


Varlable’s function. 


INITIALIZED TO: Displays the value the Reserved Varinble is set 
to at the start of program execution (i.e. at 
RUN time), 


EXAMPLECS): One or more examples using the Reserved 
Variable, 


7.4 BADINTP 


OPERATION NAME: Bad Interrupt 
MNEMONIC: BADINTP 


DESCRIPTION: Shevld an interrupt occur from an unexpected 
device or multiple interrupts occur from an 
expected device the erroneovus channel/device is 
stored in BADINTPK. Some diagnostics will use 
this information to test interrupt operation. 

If BADINTP is non-zero when an RSIO statement is 
executed, AID will report an error, 


INITIALIZED TO: Zero 


EXAMPLECS) : > 1000 RSTO AA »START CHANNEL PROGRAM 


cces one voce ecee wee ones 


> 1010 %QIF BADINTP <(>0 THEN 2000 


en etee 4000 ease eer soos 


> 41020 .OK ~- TRY NEXT STEP 


e009 enee C000 cone bens sese 
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RESERVED VARTABLES 


A000 PONS GOES C6PE HERE OEDE SOFE C40 CONS vOSe SEE CREE LOLS FERS SORE CEES SORE SOEt CIES DETE SORE OUON EROS CODE BEDE FELT CUED CEES 50 OEE ScO>F TEE BEET 2HTE OHO ~ODE HOOD BUTE SEL BEOD HERS SREE OOEE HLOE CONE FORE SEED SOUR BECE COEE HORE HOTH CORE BEES FEET OED OE0E BEES FEEE SECS DOTS HEED EEE SORE TEES DEED BODE S080 CON seme 


* Bits -42= Channel and Bits 43-45= Device 


7.2 CHANNEL 


OPERATION NAME: Set [1/0 Channel Number 

MNEMONIC: CHANNEL. 

DESCRIPTION: Specifies the channel number of the 1/0 device 
to be used in subsequent I/0 or channel progra 


operations. 


INITIALIZED TO: Zero 


EXAMPLECS): 


> 410 LET CHANNEL: =2,DEVYICE:=0 (Following 1/0 operations will 
wari execute on Channel 2, Device 0) 


7.3 CONCHAN 


OPERATION NAME: Console Channel Number 

MNEMONIC: LONCHAN 

DESCRIPTION: This Reserved Variable is initialized to the 
channel device number of the AID Console where 


bits 9-42= channel and bit i3-iS=device., 


INITIALIZED TO: Console Channel-Device number 


EXAMPLE CS): > 40 PRINT "ATD CONSOLE CHANNEL=" 3 ZCONCHAN 


> 20 RUN 


ete veee cons cece 


AID CONSOLE CHANNEL =2%40 


AMG 2 t44igOp 


RESERVED VAR TABLES 


Ree Coe SOUR Hee COED CEES SORE ODED EEE ONES StES HERS OEEE DEES EEE DEEe EEIE OOEE SESE DEES BEDE DOPE Sens COTS SEED SOS COLE FETE CEES COED BEET CEES CEES DEES BEES SETS SUEY HERS CODE OLE BEE SOtS CAED COED EOEH SEES SEOY CELE DEED CORE BtES EEaE EEG CORE BEDE HORE FOOT FEEe CECE F0ER CEFE KEES beae SOLE BEES TONS FEDS GOK Owte veee 


7.4 DEVICE 


OPERATION NAME: Set I/O Device Number 

MNEMONIC: DEVICE 

DESCRIPTION: Specifies the device number of the I/0 device to 
be used in subsequent I/0 or channel program 


operations, 


INITIALIZED TO: Zero 
EXAMPLE CS): 


> 40 LET CHANNEL: =2,DEVICE:=4 (Following I/0 operations will 


mca execute on channel @,device 4) 


7.95 FILEINFO 


OPERATION NAME: File Information 


MNEMONIC: FILEINFO 

DESCRIPTION: After aq FILENAME statement has executed FILETNFO 
contains the following information about the 
file: 
Bit 0 ={ if file protected otherwise 0 


Rit 8/14 Class of the file 
Bit 142/15 =Type of the file 


(See Diagnostic/Utility System ERS) 


INITIALIZED TO: Zero 


EXAMPLECS): Assume the file XYZ i8 protected, class 
ifdiagnostic), type G¢SPLIT) and length is 256 
words: 10 DB &AA,10,"XYZ " 


weve cove 


20 FILENAME &AACO) 


cece ooen 


30 LET A:=FILEINFO AND Z%i00000 LSR 45 
40 LET B:=FILEINFO AND 4360 LSR 4 


ame once 


SO LET C:=FILEINFO AND 417 
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RESERVED VARTABLES 


$OR0 OO BUTE C000 0900 OHRD E400 BODE LEED SHER FEED bOEe HOOT DINE CORE HERD BERD BERD C040 SAET SEED OEDD SUDO O0ED DORE SENS SOUP FINS SHOE DUE FORE COED BEND 9OED OEE SEES BODE NORD DURE OF08 BEET SANE EERE BOLD DOTS SODE BORD SENS CORI apd? CEtD ODOT HEEL WOOF OODE DITO EIDE ERED 9000 IHEP BEET SEDD DEE DOnE S00d FEED FUND bOEt Shee 0500 


60 PRINT &AAC0,2);" file “","PROTECT BIT=";A32;3 
70 PRINT "Class="3B;23;"Type="3C32;"Length=";FILELEN 
80 RUN 


wove ene 


XYZ file 
PROTECT BIT=4 Class=4 Type=41 Length=256 


7.6 FILELEN 


OPERATION NAME: File Length 

MNEMONIC: FILELEN 

DESCRIPTION: After a FILENAME statement has executed FILELEN 
contains the length of the specified file 
rounded up to the nearest 128 word sector 
boundary, 


INITIALIZED TO: Zero 


EXAMPLES) : See FILEINFO Reserved Variable example. 


7.7 GOPARAML/GOPARAM2/GOPARAMS 


OPERATION NAME: Go Parameters 

MNEMONIC : GOPARAML/GOPARAM2/GOPARAM3 

DESCRIPTION: Allows the executing program to access up to 
three parameters that may have been passed 
during the last GO Command. The default value 
of unpassed parameters is 0, 


INITIALIZED TO: Zero 


EXAMPLECS >: 
> 40 TF GOPARAM2=2 THEN SO CIF THE SECOND PARAMETER 


sr IN THE GO COMMAND WAS 2 
THEN GO TO SO) 
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RESERVED VARIABLES 


0008 $008 SEDs UOOD SEND 1860 DERE COST OOEe ODES FETE BEES OEEE BEDE BESS BUDO DUDE COEE LORE FEOD DINE SO00 BONE GUTS UTED DURE BOO BEOO OELE CODE GEO EOTE ONES HERE BEDE BOLE E400 SOOE DEER DEED BEDE BEES OPER FOND CONE CFCS S00d DEEL BEND HEED SEED DRED OUED Sete SEED BEDE BODE BEES DEEL OOEE CREF EYEE DERE sobs SIGS OOED 108 CoEG D000 OEte 


v 
3 
S 
> 
os 


7.8 INDEX 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


INITIALIZED TO: 


EXAMPLECS): 


(GOPARAMi=4 GOPARAM2=0, GOPARAMS=4) 


Buffer Compare Indicator 


INDEX 


After a compare buffer (CB) statement has 
executed, INDEX will contain -i if the buffers 
compared or it will contain the element of the 
first buffer in the CE statement that didn’t 


compare. 

Zero 

> 40 CB AAC10), BBC10),20 ASSUME AAC11)<>BBC11) 
> 20 IF INDEX=-4 THEN 80 .INDEX=1i4 

> 30 PRINT “GOOD= "S;AACINDEX) 3; "BAD="s; BBC INDEX) 

> 35 \CHECK THE REST OF THE BUFFER 

> 40 FOR INDEX:= INDEX + 4 UNTIL 29 

> $0 IF AACINDEX) (> BBCINDEX) THEN 30 

> 70 NEXT 40 

> 80 NEXT STATEMENT 


Pees onee sess once 


AMG SS 


2000 POND WORE HOLE OOES COED CIE? BEDE HOTS HERE OES UE0E EOUD BETO BEET CHRD EUEE Site CODD OFR COED EASE GUTS CEOS EOE EDTA COED CODE HORE COED SESE CODE EEE SOLE PEED COED FEEL BEDE OTE FEET EEED FOO SEED KEEE DEES SORE CECE HOEE SEED SGD ans0 TEEE SUEY BEET CFE SEND GOES COLE SEEN OEE EEbE SoEE COEe BERD OPE? EERE GOES CeNe Eee OnOD 


7.9 INPUTLEN 


OPERATION NAME: Last Input character Length 
MNEMONIC: INPUTLEN 


DESCRIPTION: This Reserved Variable contains the character 
length of the last input of the most recently 
executed INPUT statement. 


INTTIALIZED TO: Zero 


EXAMPLE(S): > 40 INPUT A 


Seep e000 epee care 


> 20 PRINT INPUTLEN 


at cone enna voce 


> 30 RUN 


? 437 
3 CINPUTLEN=3) 


of 


>? 40 INPUT A,B 


wee enee esse cece 


> 20 PRINT INPUTLEN 


etes cone cote onee 


> 30 RUN 


? 437,26 
2 (LAST INPUT WAS 2 CHARACTER,I.E.-ASCII 24) 


> 40 INPUT &AA(04,10) 


wens see cone sete 


> 20 PRINT INPUTLEN 


> 30 RUN 


ewee ween eney ence 


? HELLO 


CINPUTLEN=5 EVEN THOUGH 7 CHARACTERS WERE EXPECTED 
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RESERVED VARTABLE 


S 


eee SeeD GOOs OEMS SEER SOEe COOE FORT SIRS OUTS BRET EEUT FERS COED VERE S00E FESS SOON OOPS ODES EEDS GOED CET SEES SEDI BREE SONS BEES DUDE SEDE GUDT OOS OO80 DEEL BOLE BONE SOOT SRE SEES COLE GETS FLED GESS GUDS OEDE GEEY ESOT BEES COPE SENT SORE EONS OEE BOOS BEES BEES GOED OECD CORE SEES ERNE DERE GEES GEN ERE EONS SOOT COED Ce DOES 


7.40 MAXMEMORY 


OPERATION NAME: 
MNEMONIC ; 
DESCRIPTION: 


INITIALIZED TO: 


EXAMPLECS) : 


7.44 NEWTEST 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


INITIALIZED TO: 


EXAMPLECS): 


Maximum Buffer Area 
MAXMEMORY 


Dynamically indicates the amount of unused 
buffer space available to the executing program. 


Memory space aynilable prior to RUN time 


> 20 IF MAXMEMORY < 4000 THEN SO 
> 30 DR AA, 4000 

> 40 GOTO 60 

> SO DB AA, 2000 


(IF THE DB AT 30 WAS EXECUTED THEN MAXMEMORY WOULD 
THEN EQUAL MAXMEMORY - 40090) 


Test Command Indicator 
NEWTEST 


be used to determine 
has been specified 
to false when a TEST 
parameters and stays 
with parameters is 


This Reserved Variable may 
if a test section sequence 
externally. NEWTEST is set 
command is entered with no 
false until a TEST Command 
entered. 


Not altered at RUN time 


The XYZ Program has ten sections that are 
executed as a standard test and section 41 which 
is optional, A typical entry sequence would be: 


> 10 


> 20 


oreo cepe cote cone 


TF NEWTEST THEN 30 


LET SECTIONS 4:=!FFDF .CLEAR SECTION 44 INDICA 
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RESERVED VARTABLES 


CARS SORE C090 SED eUtD b900 GOES FORE OOED B006 0700 SOLE OPED HAND BERD EFEE URGE BUND DES CAEP CONE CINE SEES SOLE ELE AEED SECS S000 SEED HERD S000 IEE FEDS OLOE EOOE SORE 2080 FEED ORES £E99 SEED HEED SEED EOEE HENS DEED DUES EROS COLD OLE SEED SEED DEED ONE SROD SOLS FOUL DOS SEES HKD DODD BOOS ODDS ONEe CeEe Hane CODD FOND SECO beep 


> 30 continue 


‘send ened wane gee 


(See Reserved Variables SECTIONS 4/73 and Command TEST for further 
explanations) 


7.42 NOINPUT 


OPERATION NAME: Non-Error Print Indicator 
MNEMONIC: NOINPUT 


DESCRIPTION: NOINPUT is true if non-error print is suppressed 
(i.e. the SNPR Command was executed). This | 
allows the executing program to determine if a 
PRINT, INPUT statement sequence should be 
executed Ci.e., if non-error print is suppressed 
then no INPUT statement will be executed 
therefore rendering any test of the input data 
invalid). Setting NOINPUT to false will override 


the SNPR command but should be used with 
caution. 


INITIALIZED TO: Zero 


EXAMPLE(S): > 40 IF NOINPUT THEN SO 


408 Gove 2098 sone 


> 20 PRINT "DO YOU WANT TO CONTINUE?” 


fone o00t gute eect 


>» 30 INPUT & AACO) 


e000 cnet anee veer 


> 40 IF &AACO) = “Y" THEN 400 


ane pies ante wee 


> S0 END 


dtad eset cose cnn 


> 60 .NEXT STATEMENT 


If an SNPR command has been previously entered, then the program 
will skip past the INPUT sequence of statements 20 to 40, 
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RESERVED VARTABLES 
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7.13 NORESPONS 


OPERATION NAME: No Response to I[/0 Flag 


MNEMONIC: 
DESCRIPTION: 


NORESPONS 


If an I/0 instruction or channel program 
execution returns an error condition and this 
Reserved Variable is still equal to 0 then AID 
will handle the error. However, if the user 
program has changed the value of NORESPONS to 
non-zero then AID will set NORESPONS (see table 
below) and not report an error. By setting 
NORESPONS to a value other than 0 the user 
program can handle the no response error. 


NORESPONS Reserved Variable Format 


0 i 2 8 
i { BIB IN 
i + AIA tH 
i + DID tI 
i tPTIINIO 
| ee ae ee 


45 6 7 8 9 i2@ 13 iS 
i> iT dD ie it 4 BIT i: 3 BIT i 
; iOS tt CHANNEL i DEVICE : 
rr ' i 
rr i ' 
rr i i 


If NORESPONS()0 when a channel error occurs then: 


Bit 


Meaning (if set) 


S000 0000 0000 COED EOD Cnet S200 ENT SOUS SnDE eREE CURE COED DOSY END ete 


reserved 

DRTO not pointing to channel program 
Tllegal interrupt from device in Bits 9/45 
HIOP did not halt channel program 

too many device interrupts 

CCG returned after I/0 command 

channel program time out (approx. S secs) 
channel program did not start 

CCL returned after I/0 command 
channel~deyvice number when error occurred 
(bits 9-i2=channel number, bit 13-iS=device> 


INITIALIZED TO: Zero 
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RESERVED VARTABLES 


2OAe C6RS G08F BHD 20RD OERD HEED CONE BUDD HOOD S082 HUED HOHE AEOD SIE2 OEE FANS ESE OEE EOE NEED C400 COOE CORE SEES REDE CORE CODE REEL GOED HTS GORE PENS C0GT SOUR SEED COCO OPED EID CODE BETS SEHD HOES FORD OEE} SEED SONY DEEP HROD BORD ELEC 4559 S090 SEDP DEN SESE SOFT OEE UND ELLE UDES LODO OTED EGU GEE ODER SEED Cees DORE NONE 


EXAMPLE CS): > 40 LET NORESPONS:=2 
> 20 LET CHANNEL:=2, DEVICE:=7 
> 30 INIT 
> 40 IF NORESPONS=2 THEN 60 .CHECK IF INIT WAS OK? 
> S50 GOSUB 1000 »NO! PROCESS NORESPONS ERROR 
> 60 ADDITIONAL CODE 


7.44 OFFSET 


OPERATION NAME: Vary Return Point 
MNEMONIC: OFFSET 


DESCRIPTION: OFFSET may be used to vary the statement number 
returned to when executing a RETURN statement. 
OFFSET is set to zero when starting execution 
and after a RETURN statement execution. OFFSET, 
if used, may be set to any integer value 
indicating the number of statements after Cif 
positive) or before (if negative) the normal 
return statement to return to. 


INITIALIZED TO: Zero 


EXAMPLECS);: > 40 PRINT “Input yes or no" 


> 20 INPUT &AACO) 


ence gnee 2008 eone 


>» 30 GOSUB S00 .GO CHECK FOR YES OR NO 


> 40 GOTO 100 .6O TO "YES" ROUTINE 


2 HHO ated gece 


> SO .START NO ROUTINE 


>S00 IF &AACO>="¥" THEN S40 RETURN NORMALLY 


>S10 LET OFFSET: =14 sFORCE RETURN TO SO 


>S20 IF &AACO)="N" THEN 540 


‘weed enee case coor 


>S30 LET OFFSET: =-3 “FORCE RETURN TO 10 


over H0E> ente cone 


»>S540 RETURN 
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STATEMENTS ~ I/0 NON-CHANNEL-—PROGRAM 


| Onan GOee cone cue ebte ones OtUD COED SEND een) vee He=t GND CEE SUED enRe FeEe euED GRC ERED Sete BORD GOED EERE GeO COET SatY BONE SEY One SHO OEE on8e Hun ERE GERD E880 cEED Ente SiRF teEE GORY EoED ONY SnES eenD Cote Gens GotN Segy eunE eEte fete LONE nee Hate enon sew ease CaRD sney SING fnew eene OteN SEES Sent enee cone 


m+4+( 2k) 


XAMPLECS) 1 


» 40 


> 20 


cote gene sate este 


> 30 


» 40 


» 50 


>» 40 


» 65 


eee enon ence coos 


> 70 


eves eoep cope cnee 


>200 


210 


Se disoadianathenad 


»220 


230 


»240 


250 


»260 


270 


>280 


c>7) 

LET CHANNEL ;=S Define Disc 

DB AA,3 Create Buffer 

LET AACOD: 21303 Disc Status Command 
To Unit 3 

GOSUB 200 Get Disc Status 

PRINT "DISC STATUS = "s;AAC4) ;AAC2) 
Output Result 

END 

BSIO BB »Kuild Channel Program to 
Get Status from the Disc 

WR 8,AACO) ,2 Output Status Command 

RR 8,AACL) ,4 »Input Two Status Words 

IN H -End of Channel Program 

RSIO End of Definition of 
Channel Program -~ Start 
“Execution 

RETURN 
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8.3 COPY 


OPERATION NAME: Copy Channel Program 
MNEMONIC : COPY XX €XNJ 


DESCRIPTION: Duplicates the master channel program in XX into 
all copies of XX. If the optional ¥N is added 
then only the Nth copy of XX will be duplicated. 
Since the RSIO instruction automatically 
duplicates copies COPY would be needed if 
modification to a channel program is needed 
before execution (See example). Note: Copy 
number 0 is the first channel program copy. 


EXAMPLECS): > 40 LET CHANNEL: =2, DEVICE: =4 


> 20 BSIO AA,3 CREATE 3 COPIES OF CHANNEL PROGRAI 


cece anes seee osee 


> 30 INH,4,5 


oore eect e000 comp 


> 40 ESTO 


cose pene cone eset 


> SO LOCATE 30,A .GET IN H POINTER TO COPY 0 


> 60 LET AACAD:=6 . CHANGE HALT CODE TO 6 IN COPY 06 


> 70 RSIO AA,0 »RUN FIRST COPY 
> 80 COPY AAO »DUPLICATE FIRST COPY ONLY 
> 90 GOTO 69 :LOOP ON CHANNEL PROGRAM 


ence wese wave sous 


8.4 CPYVA 


OPERATION NAME: Set User CPVA 
MNEMONIC: CPVA XXCN) 


DESCRIPTION: Sets a pointer to the data buffer XX(N) as the 
CPVA during subsequent channel program 
executions. The data buffer XX must be declared 
at least 7 words long. If this statement is not 
used the CPVA pointer defaults to absolute 
memory and is not accessible by the user. 
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) £000 enes epee eRee ware S000 See SOTE S000 OuEE Bees Cree ease one” seee 


XAMPLE(S) : 


3.5 ESIO 


IPERATION NAME: 
iNEMONIC: 


JESCRIPTION: 


=XAMPLECS) : 


B.& HIOP 


JPERATION NAME: 
MNEMONIC ; 


DESCRIPTION: 


EXAMPLECS) : 


STATEMENTS - I/0 NON-CHANNEL-PROGRAM 


PERE C00 ned SEE ERE COND CERT COse SEED BEET BEET OEE COPS CONE EES Fone Sess BEES OxEN SOOT SETE ESSE COED FORE BOTS SET SEES GREE COE C080 SEED FREE CEOS SEED DEES ODES DONT SORE EOE DEES ORID GOT BORD SEED CONS CERT BEES GOES eeee SEES SoEd Sone OOOH SEF 


> 40 DB AA,7,0 
> 20 LET CHANNEL: =3,DEVICE:=4 
> 30 CPVA AACO) SET CPVA POINTER TO AACO) 


End Channel Program Definition 
ESTO 


This statement is used to mark the end of the 
definition of a Channel program. 


Halt Channel Program 
HIOP 


This statement, when executed, will terminate 
the channel program executing on the currently 
selected device. 


> 40 LET CHANNEL: =5 


eeee cane anes on90 


> 20 PROC ~SET PROCEED MODE 


Peer anme enee cove 


> 30 BSIO AA 


eee eove cote ere 


> 40 JUMP SO 


o00n aced eos cone 


> 50 JUMP 49 


> 60 RSTO Start Program Which Never Ends 


et0s ener gave ones 


> 70 HIOP »Stop Channel Program 


eeee coes ence eoee 
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STATEMENTS ~ I/0 NON~-CHANNEL~-PROGRAM 


8.7 INIT 

OPERATION NAME: Initialize I/0 Channel 

MNEMONIC: INIT 

DESCRIPTION: This statement will initialize the currently 
selected channel. The following actions take 
place. 


(4) Operations in progress on the channel are terminated. 
(2) The channel interrupt enable bit is cleared, 
(3) Channel registers are set to initial valves, 
(4) HP-IB is set to idle state. 
(S$) The fourth word of each DRT for this channel is cleared, 
(6) The mask bit for this channel is cleared 

(memory location 7). 


8.8 IOCL 


OPERATION NAME: I/0 Clear 
MNEMONIC: TOCL 


DESCRIPTION: This statement will clear all 1/0 channels. The 
following actions take place: 


(4) Operations in progress on each channel are terminated. 
(2) All channel interrupt enable bits are cleared, 

(3) Channel registers are set to initial values, 

(4) All HP-IBs are set to the idle state. 

(S$) The fourth word of each DRT is cleared, 

(6) All mask bits are cleared (memory location 7). 


3.9 ION/IOFF 


QPERATION NAME: Enable/Disable External Interrupts 


MNEMONIC: ION/IOFF 


DESCRIPTION: IOFF will disable the external interrupt system 
by clearing the interrupt bit in the status 
register. Use ION to enable external 
interrupts. 
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8.10 LOCATE 
OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLECS) : 


8.41 PROC 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


STATEMENTS ~ I/0 NON-CHANNEL-PROGRAM 


C000 POPe Gene GODS SETS OtEe SEES OETE OIF) CORP COED HOUR GOT COTE COS: EEEE BEST IDET CORD HEED COTE EOET EPDE LONE SENT GOEE BEES SORE SEED OEE GOES ODEE EEdE HELE SEED REDE BEES BEES EEE S000 FOES ODS EDEL OEDS COLE CURE SREY SEED OSE $500 COND EES ENLS SINE FOOD ORUT ERED UDOT SEES 40n OREO OfER COED Cndy Cote OETe feee 1008 tue COED 


Locate a Channel Program Element 
LOCATE (€Ccopy),] label [Coffset)],variable 


Finds the element within a channel program 
buffer correlating to the second word of a 


channel program instruction (specified in label) 
and stores that word in the parameter variable. 
If the optional copy is used (where O¢=copy<=3i 
and default is 0) then that copy of the channel 


program is used. If the optional offset is 


added (default is 0 offset from the second ward 
of the channel instruction) then that many words 
are added (or subtracted) to the result stored 


in the parameter variable, 


Note: Copy number 0 is the first channel 
program copy. 


> 40 LET CHANNEL: =2 


> 20 BSIO AA 


> 30 IN H,4,3 


> 40 +ESIO 


> S50 LOCATE 30,A .GET POINTER TO 2@ND WORD OF IN H 


cone cnee enue cone 


> 60 LET AACAD:=5 .CHANGE HALT CODE TO S. 


Proceed 


PROC {NJ 


This statement is used to enable(or disable when 
the N is added) the proceed mode. AID normally 


waits for each Channel program to interrupt 


before continuing to the statement following the 
RSIO, This normal mode of having 170 with wait 


maybe changed to the proceed mode(i.e. I/Q 
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eee GOO CONE OnE 0008 SATE SORE UEID SEED C560 COLT COD COND EET BEES SOOT CODD SOND GIDE HEED CES HORT GORD OUST FEDS SUDD COTS SENT GENE FOUR SEED TEED SEDE BEES SETS S00 PELE CODE ORES OEE CODD SEES OOEE CLE NETS OOTP SO0E OEUD DEEP CEES OETD DEED COED HOES BENE ODED CECE BEDE SOUT DEED SESE CNOD EET ONDE SEEE COED EERE Bete HOS O1E8 


without wait) by using this statement. 


EXAMPLES): (Assume AA and BB are predefined Channel program 
buffers) 
> 990 PROC »PERFORM I/0 WITHOUT WAIT 


> 1040 LET CHANNEL :=2 


>» 1020 RSIO AA »START CHANNEL PROGRAM AA 


> 4030 LET CHANNEL: =3 


> 1040 RSTO BB “START CHANNEL PROGRAM BR 


> 1050 PROC N WAIT HERE FOR I/0 TO FINISH 


8.42 RDRT 


OPERATION NAME: Read DRT Word 


MNEMONIC: RDRT Z,X 
RDRT Z,XX(N) 


DESCRIPTION: The DRT(device reference table) entry is 
| selected by the currently selected channel 
device, Z is the DRT word to read (0 <= Z «= 
3). The word read is stored in X or XX(N), 


EXAMPLE (CS): > 40 LET CHANNEL: =2 


> 20 RDRT 3,A -PLACE DRT WORD 3 IN A 
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8.413 RIOC 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLECS): 


8.44 RMSK 


OPERATION NAME: 
MNE MONIC; 


DESCRIPTION: 


EXAMPLECS) : 


STATEMENTS ~- IT/0 NON-CHANNEL-—PROGRAM 


Cote CEOS TOSS FOOL SOND SEED S008 BOSS CONS BESO DERE EELS DUDS SOE DEES BEES EERE EEE GUD CONS CORD DEED BEEE COED BUTE CDLS BPRS ORHE BIEL OETD SOTO COED FDTD GDDe DEPT WERE QOeD COED E000 Sete SOE EET Gime COOe BaeD MNOS HEED UES ONE Sabo Shes WOT CODE 


Read I/0 Channel 


RIOC K, XX(N) £,C] 
RTOC K, X €,C] 


This statement will issue a command C (where 
O¢=C<@!IF and the default is 6) to register K (0 
<= K <= 'F) on the currently selected channel. 
The result is placed in X or XX(N), 


> 10 LET CHANNEL: =2,DEVICE:=5 


me cote ses cose 


> 20 RIOC 3,A .Read I/0 Register 3 into A 


ope 9900 cose tose 


> 30 PRINT "REG 3="3 14 


>» 40 RUN 


REG 3=!4014 


ete tm C0Se ents 8OR cone SOOF CORE CONE SOE ENED Gene Hote SEED CERT Cote SOE Cons See cese ERED 908 Seey 


Read Interrupt Mask 


RMSK X 
RMSK XX(N) 


This statement will read the mask word (memory 
location 7), and place it im X or XX(N). 


> 10 RMSK A .A = MASK WORD 


ees sess sors cose 


>» 20 RUN 
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8.45 ROCL 


OPERATION NAME: Channel Roll Call 


MNEMONIC: ROCL XX(N) 


ROCL X 
DESCRIPTION: This statement will place an interrupt mask in 


XX(N) on X. Each bit of XX(N) or X is set to 
one if the corresponding channel is present. 


EXAMPLE (S >: > 10 ROCL A 


» 20 PRINT "Channels present="35 


> 30 FOR G:=R:i=4 UNTIL 45 .See if Channel is presen 


e9ee cove ones come 


>» 40 IFN A LSL Q AND $8000 EQ !8000 THEN 70 .Is it? 


> S50 PRINT Q;1;3 Yes! Print it’s number 


soee eeew eee sone 


> 60 LET R:=R+i 


> 70 NEXT 390 


seve pede pase epee 


> 80 IF R<>i THEN 4100 Any Channels present? 


> 90 PRINT "NONE"; .No! Tell operator 
>400 PRINT 
>410 RUN 


8.16 RSIO 


OPERATION NAME: Run Channel Program 


MNEMONIC: RSIO (XX €,(€C1£,8N373 


DESCRIPTION: This statement may be used instead of ESIO to 
terminate Channel program definition. XX (a 
buffer) may only be added when outside Channel 
program definition. See BSIO for more 
information. This statement differs from ESIO 
in that it initiates the Channel program 

xecution. C is the copy number (0 «= C <= Si). 
Default for C is 0. SN, if added, is the 
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EXAMPLECS): 


8.47 RSW 


OPERATION NAME: 


MNEMONIC: 


DESCRIPTION: 


EXAMPLECS) : 


STATEMENTS ~ I/0 NON-CHANNEI.—PROGRAM 
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statement number to execute next if an error is 
detected during execution of the RSIO. Note: 
Copy number 0 is the first channel program copy. 


> 40 LET CHANNEL: =S Define Device 

> 20 BSIO AA Create First Program 
> 30 INH 

> 40 RSTO Run First Program 

> $0 BSIO BE Create Second Program 
> 60 IN 

> 70 ESIO 

> 80 RSIO AA Run First Program 

» 90 RSTO BE »Run Second Program 
>400 RUN 


vee sone sooo cove 


Read Switch Register 


RSW X 
RSW XX(N) 


This statement when executed will place the value 
of the switch register in X or XXC{N). 

BRits 43-45 hold the device number, and bits 

9-12 hold the channel number, 


> 10 RSW A 


ooee noes ebas seen 


> 20 PRINT "Switch Register=";!A 


>» 30 RUN 


ones eae e600 ewes 


Switch Register=!20 


End of AID user program 


ed 
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8,49 SMSK 


OPERATION NAME: Set Interrupt Mask 
MNEMONIC: SMSK X 


DESCRIPTION: Sends the mask word X to all channels and a copy is 
stored in memory location 7, 


EXAMPLECS >: > 40 LET A:=!4000 


S608 9000 epee 2006 


> 20 SMSK A /ENABLE CHANNEL ONE INTERRUPTS. 


8.49 UPDATEOFF/UPDATEON 


OPERATION NAME: Prevent channel programs from being updated 
MNEMONIC: UP DATEOFF/UP DATEON 


DESCRIPTION: UPDATEOFF prevents words 2,4 and S of read and 
write portions of channel programs from being 
updated by the channel program microcode. 
UPDATEON (the default condition) restores 
updating. Updating is indicated by the state of 
bit S of word 4 of Read/Write channel 
instructions. 


8.20 WIOC 


OPERATION NAME: Write 1/0 Channel 


MNEMONIC: WIOC K, XX(N), (CI 
WIOC K, X, [C1 


DESCRIPTION: This statement will write X or XX(N) into 
register K (CO¢#K<=#!F) on the currently selected 


channel, The parameters are the same as those 
for RIOC., 
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9.0 AID STATEMENTS (CHANNEL PROGRAM TYPE) 


The following Channel Program Type AID Statements must be located 
between the BSIO and ESIO Statements. The format of ench 
statement explanation ist 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLES): 


9.4 CHP 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLES) : 


General phrase of what the Statement does. 


The form that the Statement would be called in. 
X is used to indicate the variables A to Z or a 
number, XX is used to indicate the buffers AA 
to ZZ. N is the same as X but is used as an 
index (XX (n)). 


A detailed explanation of the Statement’s 
function. 


One or more examples using the Statement. 


Command HP-IE 
CHP VO0O,(€V4i, . . VN] 


This statement executes the Command HP-IB 
channel instruction. VN is the Nth HP-IB command 
COC@NC=7) and is a reference to a variable or 
buffer element which contains the command or is 
the command in numeric form, 


> 40 LET CHANNEL: =5, DEVICE: =4 


tate epee onay toe 


> 20 BSIO AA 


> 30 CHP 13F,!SE,!25,!6F 


> 40 .UNLISTEN, TALK 30, IDS-LISTEN, ENABLE DOWNLOA 


> SO RSTO 


S000 cons Bese coon 


> 60 RUN 


cove epee send ses 


NOTE: VN (a 16-bit quantity) is converted to a byte and stored in 
the CHP portion of the channel program, 
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OPERATION NAME: Control Clear 
MNEMONIC: CLEAR £X] 


DESCRIPTION: This statement executes the Clear channel 
instruction. Commands the currently selected 
device to clear itself, If the optional X is 
added it forms the control byte(where 0<=X<=!FF 
and the default is 0) in the channel 
instruction. 


EXAMPLES): > 40 LET CHANNEL: = 


cote cece cece see 


> 20 BSIO AA 


eeve vene ence cece 


> 30 CLEAR -CLEAR CHANNEL S, DEVICE 0 
> 40 RSIO 


9.3 DSI 


QPERATION NAME: Device Specified Jump 


MNEMONIC: DST SOLKROIL SICKRA1,..£,SMOKRMIT,..2705XX(N)I 
DSI SOLKROIL,SAf#R41..,.0,SMCKRMI],,,7103X) 


DESCRIPTION: This statement executes the DSJ channel program 
instruction. A jump occurs as a result of the 
byte returned from the device, If XX(N) or X is 
added, then the byte returned (last byte should 
the DSJ execute more than once) or !FF Cif the 
DSJ never executes) is placed in the right byte 
of XX(N) or X,. The left byte of XX(N) or X will 
be set to 0. SM is the statement to execute 
when the returned byte of the DSJ is equal to M. 
SM must be in the same Channel program. RM is 
the total number of jump address copies of SM to 
build into the DSJ instruction. 


EXAMPLE (S) : > S DB BE,7,0 
> 7 CPVA BRCO) Define CPVA 
) 40 LET CHANNEL: =5 Define Disc 
» 20 BSTO AA Begin Channel Program 
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9.4 IDENT 


OPERATION NAME: 


MNEMONIC: 


DESCRIPTION: 


EXAMPLES): 


DSJ 40,60;A Stuff return byte into A 
> 40 INH, 0, 7 .Error~-Store halt code 7 
> 50 .In CPVA0 
> 60 IN H .OK~-Clear CPVA0 
> 79 RSIO Start Execution 
> 80 PRINT "DSJ=3;A3;25; "CPVA0=";3 BBO) 
pacers Output Results 
Identify 


IDENT XX(N) 
IDENT X 


This statement executes the IDENT channel 
program instruction. The word returned fram the 
device (last word should it execute more than 
once) om !FFFF Cif it never executes) is placed 
in XX¢N) or X, 


> 10 


> 20 


> 30 


> 40 


yOee cess once ease 


> 50 


eee gree cee nace 


> 60 


> 70 


Cece wees see seco 


LET CHANNEL: =5 Define Dise 

DE BE,S Create Buffer 

BSIO AA »Begin Channel Program 
IDENT BRC7) Stuff ID into BBC7) 
IN H Stop Execution 

RSTO Start Channel Program 


PRINT “IDENTIFY CODE =";BRBC(7) 
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9.5 IN 


OPERATION NAME: Interrupt Halt or Run 


MNEMONIC: IN HC, €X1£,€71 
IN RC, €X1£,C33 


DESCRIPTION: Executes the INTERRUPT channel program 
instruction, R, if used, will allow the Channel 
program to continue to run when this instruction 
igs reached, H, if used, will cause the Channel 
program to halt when this instruction is 
reached, X is the CPVA offset (0 (= X (= 3), C 
is the code to store at CPYVAX on 
interrupt(0<#C<=255), Default for both X and C 


is 0. 
EXAMPLE CS): 
>» 4 DB BB,4 
> s CPVA BRO) DEFINE CPVA 


ene ta0e enew core 


> 6 LET CHANNEL: =S 


Sete o00n e000 eoee 


> 40 BSIO AA Define the following Channel Program 
> 20 IN R,3,14 .CPVAS ; = f 

> 30 IN R,2,2 sCPVA2Z : = 2 

>» 40 IN R,1,3 ‘CPVAL ; = 3 

> $0 IN H,,4 Stop Program Set CPVAD : = 4 

> 60 RSTO Execute the Above Program 


un cove e000 voee 


> 70 PRINT "“CPVA0="3BBC0);2; "CPVAL=!BBC4) 


teen cote sone sone 


> 80 PRINT "CPVA2Z=";BB(2) 52; "CPVAS=" 5 BBS) 
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9.6 JUMP 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLE CS) 3 


9,7 RB 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


STATEMENTS ~ T/Q CHANNEL PROGRAM 
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Direct Jump 
JUMP SN 


This statement executes the JUMP channel program 
instruction. SN is an ATD statement number. The 
statement number must be within the same Channel 
program, 


> 10 LET CHANNEL: =S Define Disc 


> 20 BSIO AA 


> 30 DST 40,5034 Does Disc respond? 

> 40 JUMP 30 \No! Wait some more. 

> 50 IN H Yes! Exit Channel program, 
> 60 ESTO 


>» 70 RSIO AA 


aeee sore ence teow 


Read Burst 


RB MOD, XX(N), BC €,CBLIC,£DC=XIC,CRIC,CTDIIII 


This statement executes the Read Burst channel 
program instruction. MOD is the device dependent 
modifier (Q¢SMOD<H!14F),. If MOD IF then Read 
Control is used instead of Read. XX(N) defines 
the initial buffer location where the data is to 
be stored. BC is the total number of bytes to 
be read. BL is the burst length (default is 4) 
4¢=BL¢=256, Burst length is the number of bytes 
to rend this time through the RB. DC, if added, 
will allow separate data buffers to be linked 
(chained) by using sequential RE statements. X 
is equal to number of links to follow, R, if 
added, will cause the data to be stored starting 
in the right byte of XX(N) (default is the left 
byte). TD, if added, is the statement number to 
which channel program execution is transferred 
upon successful completion of the RE. 
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EXAMPLE(S): > 40 LET CHANNEL: =7 
> 20 BSIO BB »Begin Channel Program 
> 30 RB 0,AACO),4 Read One Byte Into 
» 40 Left Byte of AAO) 
> S0 INH Done 
> 60 RSTO Execute Channel Program 


> 40 LET CHANNEL: =2 
> 20 DB AA,4 


> 30 BSIO BR 


> 40 RB 34,AAC0),1 Read self test results 
> S50 IN H 


> 60 RSIO 


9.8 RDMAE 


OPERATION NAME: READ DMA Burst 
MNEMONIC: RDMAB XX(N), BCL, (BLIC,RIC,TDIII 


DESCRIPTION: This statement executes the Read DMA Burst 
channel program instruction. The parameters are 
the same as those for RE except the modifier and 
DC are deleted. See HP-300 I/0 ERS for 
definition. 
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9.9 RDMAR 


OPERATION NAME: 
MANEMONIC: 
DESCRIPTION: 


9,40 RMW 


OPERATION NAME: 


MNEMONIC : 


DESCRIPTION: 


9.44 RR 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


STATEMENTS ~- I/0 CHANNEL PROGRAM 
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READ DMA Record 
RDMAR XX(N),BC C€,€RIC,TDII 


This statement executes the Read DMA Record 
channel program instruction. The parameters are 
the same as those for RR except the modifier and 
DC are deleted. See HP-300 I/0 ERS for 
definition. 


Read Modify Write 


RMW K, BN, C 
RMW K, BN, S 


This statement executes the Read Modify Write 
channel program instruction. K is the register 
to be modified (O¢=K<=!F), BN is the bit number 
of register K to modify (COC=BNC=!F), C will 
clear the bit and § will set it. REGISTER K is 
read, bit number BN is modified, then register K 
is written. For some registers BN has special 
meaning. See HP-300 I/0 System ERS for further 
register definition. 


Read Record 


RR MOD, XX(N), BCE, CDC=XIEC, CRIC, TDI) 

This statement executes the Read Record channel 
instruction, MOD is the device dependent 
modifier (O¢=MOD<=!1F). If MOD is greater than 
{F then Read Control is used instead of Read. 
XX(N) defines the initial buffer location where 
the data is to be stored. RBC is the number of 
bytes to be read. If R is added will cause the 
data to be stored starting in the right byte of 
XXCN) (default is the left byte). DC(data 
chain), if added, will allow separate data 
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buffers to be linked (chained) by using 
sequential RR statements. X is equal to number 
of links to follow, TD, if added is the 
statement number to which channel program 
execution is transferred upon successful 
completion of the RR, 


EXAMPLECS): 


> 400 RR O,JI(0),256,DC=2 READ 4 SECTORS. PLACE THE 


rH te Oven cone Hehe 


> 110 RR 0O,BBCO),5412,DC=41 . FIRST ONE IN JJ AND THE LAST 


> 120 RR O,FF (128) ,256 » ONE AT FFC128) 


9.42 RREG 


OPERATION NAME: Rend Register 


MNEMONIC:; | RREG K, XX(N) 
RREG K, X 
DESCRIPTION: This statement executes the Read Register 


Channel instruction. K is the Channel Register 
to be read (O¢=K¢C=!F), XX¢N) or X is where the 
data ig placed. If this statement doesn’t 
execute then !FFFF is placed in X or XX(N), 
Should this statement execute more than once, 
the last valve read will be placed in X or 
XXC(N), 


9.13 WAIT 


OPERATION NAME: Wait 


MNEMONIC: WAIT (S] 


DESCRIPTION: This statement executes the WAIT channel program 
instruction. The channel program is suspended 
until the device requests service. If S$ is used 
then bit 15 of the first word of the wait 
instruction is set. The special mode is 
described in the HP~300 I/0 ERS. 
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EXAMPLES): 


9.14 WB 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLECS): 


' STATEMENTS = T/0 PnOnNe’ PROGRAM 


> 10 LET CHANNEL: =S 

> 20 DB AA,3 

> 30 LET AACO):=!200 Seek Command 

> 40 LET AACL):=100 Cylinder 100 

> SO LET AAC2Z):=!1105 Head 1,Sector S 
>» 60 BSIO BB 


> 70 WR 8S, AACO), 3 Issued Seek 

)» 80 WAIT Walt for Completion 

» 90 IN H » Done 

1400 RSIO Start Channel Program 


Write Burst 
WB MOD, XX(N), BCL,CBLJ €,€DC=XI£,CRIC, €€22313 


This statement executes the Write Burst channel 
program instruction. The parameters are the same 
as those for RB except the TD ls not valid and & 
is added to flag the end of each burst with the 
HP-IB END message. 


> 40 LET CHANNEL: =7 


coed ence case come 


» 45 DB AA,6 


> 20 ESIO BB »Begin Channel Program 


> 30 WB O,AA(S),4,,,R Write One Byte 


>» 40 From the Right 
> 50 Byte af AACS) 
> 60 IN H Done 

> 70 RSTO 
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“OR 
> 40 LET CHANNEL: =2 
> 20 DB AA,1,0 Control byte is 0 


> 30 BSIO BB 


> 40 WB 34,AAC0),4 ‘Initiate Self test 
> S50 INH 
> 60 RSTO 


9.45  WDMAB 


OPERATION NAME: Write DMA Burst 

MNEMONIC: WDMAB XX(N), BC £€,CBLIE,ERIC ETT) 

DESCRIPTION: This statement executes the Write DMA Burst 
channel instruction. The parameters are the same 


as those for WB except the modifier and DC are 
deleted. See HP-300 I/0 ERS for definition. 


9.46 WDMAR 


OPERATION NAME: Write DMA Record 
MNEMONIC: WDMAR XX(N), BCEL,RI 
DESCRIPTION: This statement executes the Write DMA Record 


channel program instruction. The parameters are 


the same as WR except the modifier and DC are 
deleted, SEE HP-300 I/O ERS for definition. 
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9.47 WR 


OPERATION NAME: 


. MNEMONIC: 


DESCRIPTION: 


EXAMPLE(CS) : 
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Write Record 
WR MOD, XX(N), BCE, CDC=NIC£, RII 
This statement executes the Write Record channel 


program instruction. The parameters are the same 
as those for RR except the TD is not valid. 


> 10 WR O,JJ (0),256,DC=2 .WRITE 4 SECTORS. GET FIRST 


> 20 WR 0,BB(0),512,DC=i . FROM JJ, THE NEXT TWO FROM BE 


> 30 WR 0O,FF(128) ,256 » AND THE LAST ONE FROM FFC(128). 


9.18 WREG 


OPERATION NAME: 
HNEMONIC: 


DESCRIPTION: 


9.49 WRIM 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


Write Register 


WREG K, XX(N) 
WREG K, X 


The parameters are the same as those for RREG. 


Write Relative Immediate 
WRIM Z,CX] 


This statement executes the Write Relative 
Immediate channel program instruction, Z is the 
displacement from the next instruction of the 
channel program (~-128¢=Z¢=127),. XxX is the data 
to write into the channel program at that 
location. If Z is negative then X is not used. 
The constant used is what is already in the word 
at WRIM execution time (See HP-300 I/0 ERS for 
further details), 
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EXAMPLE(S): > 400 JUMP 140 Jump to 4130 Second Time 


e109 Gone cope cone oOEe 


> 440 WRIM -3,4 ,Change 400 to JUMP 430 


> 420 JUMP 100 


ese gene cose cece onee 


> 4130 INH 


sent 900s cate cone cave 
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10.0 FUNCTION STATEMENTS 


This section defines the statements used in creating programmed 
functions. 


10.14 ENDF 


OPERATION NAME: End Function Definition 


MNEMONIC: ENDF 
DESCRIPTION: This statement terminates a Function definition. 
EXAMPLECS);: See FUNCTION statement, 


10.2 GETNAMEDATA 


OPERATION NAME: Get data found offset from NAME parameter 
MNEMONIC: GETNAMEDATA NAMEx, offset, variable 


DESCRIPTION: Provides access to the memory location offset 
from the pointer found in NAMEx. If a buffer was 
passed as the NAME parameter then the element of 
the buffer plus offset is stored into variable. 
If a buffer was not passed then an AID execution 
error is reported, 


EXAMPLECS): id DB AA,100 


4100 FUNCTION DOIT NAMES 
140 GETNAMEDATA NAME1,5,A .Store contents of AACIS) int 
420 GETNAMEDATA NAME1,-3,B Store contents of AAC7) in 


200 ENDF 


500 DOIT AACLO) 
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10.3 GETNAMEINFO 


OPERATION NAME: Get NAME parameter information 


MNEMONIC: GETNAMEINFO NAMEx €,XI30,YI0,Z1 
DESCRIPTION: Provides the identity of the NAME1/6 porameter 
including: 


Type~ simple yvariable,reserved variable ,data or 
string buffer. 

Name-~ A through Z or position of reserved variable i 
AID Reserved Variable Table, 


Element~ number of the buffer element passed. 
Length Size of the buffer in words. 


X, if included, is stored with the following 
information: 


2000 O0FE C088 2020 SO8F CURE FORE CORE SONS SEED HEE0 COE BOLE SED SOP CUES SOEe COGS CEce FEED SODE FOEY BOLE SHED S000 OEd HEED SEED DuES ShED EET ONES SOE SHOE OFEE SEHE Cnn Sone 


type=0 for data buffers CAA-ZZ) 
i for string buffers (CA&AA-&ZZ) 
2 for reserved yvariables (MAXMEMORY-FILELEN) 
3 for simple variables (A-Z) 


name=Zi04 for A,AA or &AA through 4132 for Z,ZZ or &ZZ. 
If type is a reserved variable then name equals 
the offset from the first reserved variable in 
memory (See AID LIST R Command for their order). 


Note: if a NAME parameter is not passed then X is 
defaulted to that name parameters Reserved 
Variable. 


Y, if included, is stored with the element passed 
if the NAME parameter was o buffer else -1. 


Z, if included, is stored with the length of the 
buffer passed in NAMEx, If a buffer wasn’t passed then Z is 
stored with -i, 


EXAMPLECS): 
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40 DE AA, 100 


400 FUNCTION EXAMPLE NAME4,NAME2 , NAMES, NAME4 

440 GETNAMELNFO NAME4,4,B,C .A=%404(ID), B=S(elemant) ,C=4100 (length) 
420 GETNAMEINFO NAME2,D,E,F .D=O0(default parameter) ,E=F=-4 

430 GETNAMELNFO NAME3,G,H,I .G=%440432(ID) ,H=l=~4 

440 GETNAMEINFO NAME4,J,K,L .J=%10000S(Sth Reserved Variable) ,K=L=~4 


S00 EXAMPLE AACS),,Z,STEP See FUNCTION EXAMPLE 


40.4 FUNCTION 


OPERATION NAME: Function Declaration 
MNEMONIC;: FUNCTION name [{porametersI 


DESCRIPTION: Defines the entry point and parameter format of 
subsequent function calls. The function 
capability enables the user to create 
quagsi-statements with an unique name and 
parameters where: 


name= maximum of 8 alpha characters. 
parameters= Pn £€,Pn.....,Pn] 


where! 
P= NAME for a variable or buffer 
passed by name. 
VALUE for a constant, variable or 


buffer passed by value, 


n= ordinal numberxX of P where 1 is 
the first parameter of the 
NAME or VALUE type and i¢=n<=6, 


The following ruleskk govern FUNCTION use: 


(14) Calls to the FUNCTION Statement must insure all parameter 
types are matched. Any parameter may be defaulted i.e. 
excluded, except the NAME type when it’s used as a read/write 
buffer(e.g. RR O,NAME1,5). Defaulted VALUE parameters are 
assigned the quantity 0 and defaulted NAME parameters are 
assigned to the Reserved Variable bearing their name, 
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* Example: VALUES, VALUE? ,NAMEL , VALUES ,NAME2 ,VALUE4 , NAMES ,NAME4 


KK See the respective examples on the following pages which 
display rule usage. 


(2) Function calls may not be input unless the appropriate . 
FUNCTION Statement is already in the program. If a FUNCTION 
Statement is deleted any calls to it render the program 
unexecutable and a LISTing of the function calls will yield a 
warning message, 


3) A FUNCTION calling a FUNCTION is allowed but Limited to the 
amount of space available to the user program (i.e, every 
FUNCTION call places a 43 word information block into the 
user area and each ENDF Statement removes just one 
information block). 


(4) The FUNCTION Statement may never be executed in line, i.e. it 
must be called, and a branch into a FUNCTION-ENDF Statement 
sequence during execution will produce an error, 


(CS) ALL AID Statement ,Command, Reserved Variable keywords (e.g. 
LET, TEST,etca,>) and the buffer names AA to ZZ are reserved and 
an attempt to input a FUNCTION statement name using such a 
keyword will result in an error, 


Limitations using functions: 


(a> Use of name buffers, i.e. NAMEA-NAMES, is not allowed in 
AID Statements that use buffers without elements, @.9, 
BSIO, RSIQ, DEB, etc, 


(b> Indexing of name buffers is not allowed, i.e. NAMEGCX), 


Example of RULE 4 ¢ correct way } 


O0e COOP B000 Oh0d CORE OES CREE FOR BORE BOO HOLE FUEL COUT FOE DOLE HEED CEES ORD DESE DERE FORE HED Ee SEEE COED DERE S050 C000 DEES Cae OE0e 


> 40 FUNCTION ADDEM NAME, VALUES, VALUES 


> 20 LET NAMEL: =VALUEL+VALUER 


> 30 ENDF 


Cane sane geen ena 


>400 ADDEM A,7,2 ALB7 He 


e0ge weer 2408 gene 
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Orte CORE DOSE CORE ORE S002 GEST BEES BUED BEES BUDE GEOY BOTT BEES SOLS EEE SOTO OO0E BEDE EOS SEEF FOOD BEDE SEED FOOD SEES SOFE CODE DEED OEE WEDD TOOT EEE CORE OFFS FEES BOLE BEES BOOS COGE CREE BEDE DOES DUNE CEEe FOES BORE OLE DEED CLOT SEES ELON LEED EELS GETS EOL) S004 HORE SDD OOEE LODE SEED oEte mEe SHOE COOH OOte eee Goer DEE 


Example of RULE 4 ¢ incorrect way ) 


Sere W004 Ce $000 S0ER HERS S800 SORE DEED DORE TERE 4040 DEES CEDT CORE SEES OEEE CEES SEES TEED DEED CODD FEED SECE OEE SEED URE OTD EOOO SEO cone 


> 40 FUNCTION ADDEM NAMIE4 , VALUES, VALUE? 


> 20 LET NAME1: =VALUEL+VALUE2 


ree eee enee cone 


> 30 ENDF 


2100 ADDEM 4,7,2 


>440 RUN 


KK ATID ERROR in Statement 40 xx 


Woo eBOe cnet 904 OAT 2800 Sous BOO 2600 0990 COEE LO80 HORE D400 HEED BER FOOD DOE OEY DENT SOTR GIS 2ODE 9000 BRO HOOD OO HOTS EDEe HEN0 COCe 1000 


FUNCTION Parameter invalid or in wrong order 


6009 0000 $008 S000 9000 GOES LOE! B00 DORE S600 DORE 0900 20ER S600 0bR D800 DORE HECe GODS FEDS S008 8002 6000 PODS FOOL G00! SORE HERD SEES DOOD DOLE COE HELE 2O08 CORD Bene SOts Suse ENED CODE bYte SEEE O08 


Example of RULE 2 ( correct way ) 


(0s C80 C080 S50 0080 DORE BOER CORD OREO HED SORE BEDE S000 DOE 9000 CODE SOND CORE F089 EOE Ode BEEP COGS Date LeEe LENT BEEb SER DEET BEET SEC O9e FORE 


> 10 FUNCTION GETSR NAMES 


eane aeee esse sees 


>» 20 RSW NAMES 


> 30 LET NAMEL:=NAMEL AND !7F 


See seme cece cece 


> 40 ENDF 


eee soso eves vies 


2100 GETSR AACO) 


eee ceen sees once 


>410 


seve eaee seen sees 


Example of RULE 2 ¢ incorrect way ) 


0009 C000 CONG 6060 BEd OEEe HEEL DEEL CORE SEER COTE E80 FORT BEL BOOT C000 COTE S080 S000 DEES DEEL 8900 LEOD CODE CEE HEE EERE EDEE S100 SEE CbEL O90 Leee Gene GOET 


(Assume this is the first Statement input) 


> 10 GETSR AACO) 


gee 2006 ones cone 


a 


XX ATID Entry Mode Error *xX 
Tllegqal parameter, type or input 
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C00 Obed 200 ree ape BOSE FEOe OSD CELE DEED CELE FOES BEES SEES HOOP HOLE COS FEED SEED FEES ODF CEES SEES SORE FEDD SED SESS CPOE ECED E00 SINE EDED DERE COED EDEU POET SUD VOES FEEY DEE FEDE COER HOUR CREE OPED FEET HELE ODET HIRE COED PEDe PERE CEEE C900 COED DOCD SOEs HOLS SOUS SED FEDE S08 SEES COED DOSE OEE S400 Cate eEte See 


> 10 FUNCTION GOING NAMES ,NAME2 


cece sees ease seen 


> 20 ENDF 


Soee seas otes coos 


> 30 GOING A,B 


saee ense wate seco 


> 40 DELETE 10 


peur cave eves eves 


> 40 LIST 


eeny e009 e008 eons 


20 ENDF 


4090 eee aeee soe cone sees ence 


30 *xkUndefined FUNCTION call to Statement 10 


e0b+ PEO 950 HOLE COED O5FS FOOL SEES CONT FORP COED EEE LOTT HOLE FEE SEED OEEY HFEe HOO Mate FEED OPOn ChOd enee VEE HERE SORE EDEL OPED C950 pUEE Sees FOES COED SEEE Ente Dees GnEE oFeF HORE Stee Seet Sen Guse 


> 40 


ones sone e099 cose 


(Note~ Statement 30 is supposed to be GOING A,B 
but has no significance since Statement 
140 was deleted. Statement 10 must be 
restored with a FUNCTION Statement to 
LIST or execute normally) 


Example of RULE 3 € correct way ) 


o8Oe BOTS OLED Sone ORNS SHED SEED BEER SHEE COUT SUBS COED SEne COEF COTE SEDO DEES SESE FOES StEE VOLE SEED AETS enen VErs DPD HELE DOOD SEED aHEE exes SeEC HOEF 


(Demonstrates a FUNCTION calling a FUNCTION) 
> 40 FUNCTION ADDEM NAME1, VALUES , VALUE? 


ence suns e0ee cote 


> 20 LET NAME1:=VALUEL+VALUE? 


se0e ere, seer even 


> 30 ENDF 


euee ante coe sone 


> 40 FUNCTION GETSR NAMES 


eee eee cove apes 


> SO RSW NAMES 


een eens cove seo 


> 6&0 ADDEM NAME’ ,NAMES ,4 » Add 4 to sw. reg. 


ee0y aces cous voce 


> 70 ENDF 


sees wens sane ener 


>200 GETSR A Get sw.reg,. and add 4 to it 


evee ones ence cave 


(Demonstrates ao recursive function call) 


> 40 FUNCTION POWER NAMES, VALUES, VALUE2,NAME2 


tae epee ses sce 


> 20 IF VALUELC 4 THEN SO 


see wove eaee cons 


A4iH~ 30 


STATEMENTS ~- FUNCTION 


cute D600 SOUR S000 SEES DESe SEES S002 CEES SORE SETS CEES CEES OEEd OuET She CEES HENS SEE COLT Gee CEES DEES EOFS EFSS CORE DEEE HOES REDE SEE CEOS HES FOES GEES UES SEY DEOL OEDE SObS LETT DeSe EEDE FEEL RODE FEET DOLD SEES LOOT COR SEEE COE O00 OEEE BEES COE SEED BODE Gots ODEe EOES FOOL OEED SEEt SEE HEbE OERE FOED HERD EOFS OED 


> $0 LET NAME2:=VALUE2:=NAMELXVALUE2, VALUE: =VALUE4-4 


> 40 POWER NAME, VALUES ,VALUE2,NAME2 


ees wwrs e909 cece 


> SO ENDF 


t000 ence suet soce 


>200 POWER A,7,1,B .Get A to 7th power and put in E 


eee 00s core seve 


Examp le of RULE 3 € incorrect way ) 


C000 0000 ORS 0000 4000 See GORE OEE HOE BILE CEE LOTD CEES BEES HOCG BEES FEEL EERE SEES FREE FORD OODH TOFD SOEE FOES BORE Sone DELe OEE CEES OEOD Rabe AeEn OoEe SEO 


> 40 FUNCTION FOREVER NAME4 


Mae sass anes soee 


> 20 FOREVER NAMES 


cess nee weee coe 


> 30 ENDF 


waee wose eons sone 


>400 FOREVER A 


cece arse cows sone 


>440 RUN 


meee geee ween coee 


*K AID ERROR in Statement 20 x 


Gree tebe enee 080 eose Bees seus SeEe Sete Sete CHEE ROLE HEBD SEOe SEES SORE FEEL OEED FOES SEEE CEES CONS DEEe SLES cate SEES CUES HeEe eneD ore HOES exes 


Data buffer area overflow 


200d COCe OUCe COON 0688 Dene DERE SAME OnE EET CtON DEES TED BOSD LOTT DED BEDE SOLS Dene SEES DONS SEES Cone cons one 


(Statement 20 will build 43 word blocks until no more 
user space is available at which time the program 
will abort> 


Example of RULE 4 ¢€ correct way > 


CMe e40e SOEs HOOD COON Sees ehas FOEe COED COEF HORE CONE BOSE ere Sots BEED SOE COTE CEES SHEE EDEL SEE SEES Stee ORE CONE wnte CEdE VOEE OOre Sten COEe Sent 


> 40 GOTO 300 |. Branch around Functions 


eave cose eee seen 


> 20 FUNCTION POWER NAME, VALUES 


2290 ENDF 


wane wore ncte cone 


+300 .Start of normal program 


wete sone econ cece 


Example of RULE 4 ( incorrect way ) 


M000 2000 Cote E088 OOP exer F000 Oeee 4000 SOBY AEDS SERS CORD BNES ERD EEE COE EEEO GOES LEOE 90S BEET 9OEE EPO CODE DEED SECS SEES SED FEES FEO Seb Sone cEEE St08 


> £0 FUNCTION POWER NAMES , VALUE 


eve cece wees enee 


44iH~- Si 
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9008 OO8L PEE BOND SORE 2ODE FORD BERL 40Ee NERD COPE COND FEED SER 180d BEER CLEP SEED FORD BOE SEPE DOLE COE OORT FORE PED DEDS LODE SEER BOE O80 SOOP REED SEED DOE) S002 ROOT 90ED SEE OTE SEED SOLE BEDE FOEG COPD OOER FEEL BDED BEDE F000 HOLD C200 FREE DEOL ONDE FOES CORE ODED OFDD O50) CODD 9000 EONS HERE DEdD HOLE SHDe SODD eens eer 


> 20 LET NAME1: =NAME LXNAMES 


cone sean eeee oon 


> 30 ENDF 


ones epee bane cone 


> 40 RUN 


tees sees conn anes 


**X AID Execution Mode Error in Statement 40 *x 
FUNCTION Statement cannot be executed in-line 


Example of RULE S ( correct way ) 


OO A10E GALE TERE C608 ONDE POLE SERD 4008 CON O04 OOEE DEES DODD FFEM OEE TELE 2680 COEE NEES COLO 2008 BOTS S000 2000 OEEF FERS SEDE EHEE GOES HOEe Fhe Stee 


> 40 FUNCTION TESTX NAME .TESTX is valid 


s 


Example of RULE S ¢€ incorrect way ) 


CCHe HE0e OFEE LODE C008 FORE E640 FORD KENT COED SEOE CONE SEND AEE $108 EET OEE $008 CEOE COEO EERE CONE CONE 4OO2 FORK FONT FOES G0U0 HEE HELE ONE BOE) DERE BODE C900 


> 40 FUNCTION TEST NAMES 


a 


*K AID Entry Mode Error x 
Invalid FUNCTION name or reserved keyword 


Practical 1/0 application 


COOn bbe ute UHmG O00p E0EN BORE LONE Z80E Aone O00 SO00 HEEL GOEL tODE ODE DERE DOE DEDe FETE Cone tbs COTE sEE0 CEOE 


2400 FUNCTION READDATA VALUE, NAMES, VALUE2,NAME2 


S000 200 comt eoee 


>440 Reads data into buffer NAMEL with modifier VALUES 


eee e800 geet ea0e 


2420 . and length VALUE2 and compares the read 


ante cme eves ares 


?430 . data to buffer NAME2 


ones etee eons seee 


>440 INIT .Intialize Device 


even cone vese ever 


2450 BSIO AA. Build Channel Program 


2460 RR VALUEL,NAMES ,VALUE2 Read record 


eave tose enme oyee 


470 RSTO » Execute Channel Program 


eee eras ance otee 


2180 CR NAMEL,NAME2 ,VALUE@G Compare buffers 


9060 ere voce onan 


2490 NDF “End of READDATA 


tows s9te coon agen 


2500 READDATA 0,4AC0),256,BB(0) .Get and test data 
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2000 BE00 GEES BE) ERS BEE BURT HOOF FOES URED BREE SERS EPO wane GORE WEEE HOLE ERTS BE! CODE EEDE OEDE GOEL FOOT BEES SEED Bb0D ODT FEES SOU COON DES FOLD SEED DEE SDEE DUDE CEES BEES SODD GEdD FONE O00 FUE) CFE EES DALY COED C200 OEE S0Ee F208 SEES SOE BOOL DEEL SFOS RENE OFOE EOD) COLE REND DEEL SERS HOES OEE S0E0 WERE CORE eeOe 


e00e pone ones cone 


S10 TF INDEX=-1 THEN 550 


men eves gene ovse 


S20 EPRINTXK "Compare Error! Bad Data="s;AACINDEX); 


2530 PRINTEX “ Good Data=";BRCINDEX) 


4008 e008 cogs eons 


»540 EPAUSE 


tere @0ee sees seen 


»550 .Continue Program 


2000 wees cone soos 


10.5 SETNAMEDATA 


OPERATION NAME: Store data into a NAME buffer element 
MNEMONIC: SETNAMEDATA NAMEx, offset, variable 


DESCRIPTION: Stores the data in variable into the buffer 
element plus offset passed as a NAME paorameter., 
If a buffer was not passed an AID execution 
error Will occur, 


EXAMPLECS): 40 DB AA,100 


£00 FUNCTION DOIT NAMES 
440 SETNAMEDATA NAMEL,S,A .Store contents of A into AACIS) 
120 SETNAMEDATA NAME1,-3,B8 .Store contents of B into AAC7) 


200 ENDE 


300 DOIT AACLO) 
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et0e G0ee bee S008 HOS Cone DEpE SEED SOEs HeES uae MHD etey Sees BEES ewes 


STATEMENTS ~ I/Q CHANNEL PROGRAM 


OTe opbe Bene 206 cone Ge0E HEED SUES EEOE SEED GOS GHEE ORbY COEE POLE bie FOOT SESE SEES SOUR CODE SESE OLET ERED CESS FEEL SuEe GEES CUES SOUS BODE FORE CODE CoES OFEe SOUT BEES Cogy SEDE Dee SEES SEND SObE HOES SEES HEL OtbY eee SERS SEER Goud HN BEES SOEe 


%.0 AID STATEMENTS (CHANNEL PROGRAM TYPE) 


The following Channel Program Type AID Statements must be located 
between the BSIO and ESIO Statements. The format of each 
statement explanation is: 


OPERATION NAME: 


MNEMONIC : 


DESCRIPTION: 


EXAMPLECS) : 


9.4 CHP 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLECS) : 


General phrase of what the Statement does. 


The form that the Statement would be called in. 
X is used to indicate the variables A to Z ora 
number. XX is used to indicate the buffers AA 
to ZZ. N is the same as X but is used as an 
index (XX (n)). 


A detailed explanation of the Statement’s 
Function, 


One or more examples using the Statement. 


Command HP-IE 
CHP VO,[Vi, . . VNI 


This statement executes the Command HP-IB 
channel instruction. VN is the Nth HP-IB command 
(O¢#NC=7) and is a reference to a variable or 
buffer element which contains the command or is 
the command in numeric form. 


> 40 LET CHANNEL: =5, DEVICE: =14 


anes sees seed seen 


> 20 ESIO AA 


etee n000 sage case 


> 30 CHP !3F,!SE,!25,!6F 


were esos tase stee 


> 40 UNLISTEN, TALK 30, IDS-LISTEN, ENABLE DOWNLOA 


> SO RSTO 


omge cone sane wete 


>» 60 RUN 


NOTE: VN (a 46-bit quantity) is converted to a byte and stored in 
the CHP portion of the channel program. 


APR 10, 1979 A44iI- 


S400 COPE FNAG WOOD ORE PANS OREO COOP SEDO GOED OED FETE CIEE BEET SEED OES DOIG SEE E500 SOE SORE SOND RODS ENED EETT OPED DOFD PORT EDD CODE EPCE FIRE 2EEC BECD TEND ZOOS GLEE SEED ODE FOES anED CHES 0592 SPOT SOOY SUE 1ODE PRET ODED 2902 LECE LED 2000 SORE ROD COED COE CEPR FEES BENE BODE NET GERD 00D CREE DET ORNS CECA OnEE 8eqP 


9.2 CLEAR 


OPERATION NAME: Control Clear 
MNEMONIC: CLEAR {XI 


DESCRIPTION: This statement executes the Clear channel 
instruction. Commands the currently selected 
device to clear itself. If the optional X is 
added it forms the control byte(Cwhere 0¢=X¢=!FF 
and the default is 0) in the channel 
instruction, 


EXAMPLE CS): > £0 LET CHANNEL: =5 


eore cums quae seve 


> 20 BSIO AA 


> 30 CLEAR »CLEAR CHANNEL &, DEVICE 0 


eaee cee once oye 


> 40 RSTO 


e000 enee sete oxen 


9.3 dDSJ 


OPERATION NAME: Device Specified Jump 


MNEMONIC: DST SOCKROIL,SILKRL1,..0,SMCKRMII,..7305XX0NI 
| DSI SOLKROIL, SACHR41,,.0,SMEKRMII,,.7905XI 


DESCRIPTION: This statement executes the DSJ channel program 
instruction. A jump occurs as a result of the 
byte returned from the device. If XX(N) or X is 
added, then the byte returned (last byte should 
the DSJ execute more than once) or !FF Cif the 
DSJ never executes) is placed in the right byte 
of XX€N) or X. The left byte of XX(N) or X will 
be set to 0. GM is the statement to execute 
when the returned byte of the DSJ is equal to M, 
SM must be in the same Channel program. RM is 
the total number of jump address copies of SM to 
build into the DSJ instruction. 


EXAMPLE(S);: >» S DB BB,7,0 
> 7 CPVA BBCO) Define CPVA 
> 40 LET CHANNEL: =S Define Disc 
> 20 BSTO AA »Begin Channel Program 


AMI- 2 t444i00p 
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G00) GEOR 2OOF GOR OOOO COER ETE SPED COTE BREE OEP DEED OEE E000 HEED SEES SOR GOEP SEDE SEET COED SESE EEOE FOOT FESS REE COTE O0EE RODD BEEP ODDS OES GOES ENTE GODS SEES BODE CODD HOES BEEP CDE CODE OEDS SEES FIED ERNE CONS GOED NEES REDD BEET SEED SOND SEET GIGS GENE DEO EPTE SUEY GoD SubS SOhh KEEd GEED ange CONE EEE coEe Nene bOED 


> 36 DSTI 40,60;A Stuff return byte into A 
> 40 INH, 0, 7 .Error--Store halt code 7 
) 50 In CPVAO 

> 60 IN H .OK--Clear CPVAO 

> 70 RSIO Start Execution 


> 80 PRINT "DSJ=;A;2; "CPVA0="; BRO) 
ot Output Results 


9.4 IDENT 


OPERATION NAME: Identify 


MNEMONIC: IDENT XX(¢N) 
IDENT X 
DESCRIPTION: This statement executes the IDENT channel 


program instruction. The word returned from the 
device (last word should it execute more than 
once) or !FFFF (Cif it never executes) is placed 
in XX(N) or X, 


EXAMPLES): > 410 LET CHANNEL: =5 Define Disc 
>» 20 DB BB,S ‘Create Buffer 
> 30 BSIO AA Begin Channel Program 
> 40 IDENT BBC(7) Stuff ID into BEC7) 
> 50 IN H Stop Execution 
» 60 RSTO »Start Channel Program 


> 70 PRINT "IDENTIFY CODE =";BBC(7) 


sete Geen cane cose 
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Odd Free SHES GOES EEE DOE SEND O9NS CEEE FORD SESS LALD 482 SOUS BREE SEES OOED OEIE BEES FOES COED COED DEEP CORE BETS EID C000 C9ES CUtS SEE OEDE OHEd CUTD OEED CORY SOE0 EETE DEED FEET ONES CORD COED COED OFT CEED DETD SOUT OED CEE ENES DER) HO! OREM OUP SONS SEED POE EOE OURS COST Suse CeEE HOSE OUTS SEND bese SUED Sone Seen Bone 


9.5 IN 


QPERATION NAME: Interrupt Halt or Run 


MNEMONIC: INH, €X3€,C1] 
INR £€, €X1£,C7) 


DESCRIPTION: Executes the INTERRUPT channel program 
instruction. R, if used, will allow the Channel 
program to continue to run when this instruction 
is reached. H, if used, will cause the Channel 
program to halt when this instruction is 
reached, X is the CPVA offset (0 ¢= X <= 3). C 
is the code to store at CPVAX on 
interrupt (0¢=C¢=255). Default for both X and C 


is 0. 
EXAMPLE (CS): 
>» 4 DB BB,4 
> § CPVA BBO) »DEFINE CPVA 


nee enen see cree 


> & LET CHANNEL: =S 


oumb epee Gone coeg 


> 10 BSTO AA Define the following Channel Program 
> 20 IN R,3,14 CPVAZ + = i 

> 30 IN R,2,2 .CPVA2 +: = 2 

> 40 IN R,1,3 CPVAL 1 = 3 

> 50 IN H, ,4 Stop Program Set CPVA0 : = 4 

> 60 RSIO :Execute the Above Program 


een cone Ones cope 


> 70 PRINT “CPVA0=";BBCO) 32; "CPVAL=! BBC 4) 


> 80 PRINT "CPVA2Z=";BBC2) 32; "CPVAS="3;BBCS) 


wore s0ee wee vere 


4A41I-~ 4 


cece eee C00 euTe Sect S008 SORE apSS MABE CONE exEE Sete eEES wene eOeP COTE 


9.& JUMP 


OPERATION NAME: 
MNEMONIC: 


DESCRIPTION: 


EXAMPLECS): 


9.7 RB 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


STATEMENTS ~ I/O CHANNEL PROGRAM 


G0Ce wees one FRE ORbe GEES CEES LODE FEEL COEF CORE SORE CHES SEIT LYRE OOO EET WEES HOUT COEE FOOD Cae CRBE BEET CURD EYEE SUSE GEER BEDE LEDS SUED Sete BEDE SORT SO8D CEES SORT SOOT CEES OEE COTE TORT OEE ONES OOED BEDE SEED SENS CREE CLE RUDE Come CEE Gane 


Direct Jump 
JUMP SN 


This statement executes the JUMP channel program 
instruction. SN is an AID statement number. The 
statement number must be within the same Channel 
program. 


> 40 LET CHANNEL: =5 Define Disc 


ernn etee weno eaee 


>» 20 BSIO AA 


> 30 DST 40,50;A Does Disc respond? 

» 40 JUMP 30 -No! Wait some more, 

> So IN H »Yes! Exit Channel program. 
> 60 ESTO 


> 70 RSTO AA 


sete epee once eons 


Read Burst 
RB MOD, XX(N), BC C,CBLIC,CDC=XIC,CRIC,CTOIII) 


This statement executes the Read Burst channel 
program instruction. MOD is the device dependent 
modifier (O<¢=MOD<=!4F)>. If MODDIF then Read 
Control is used instead of Read. XX(N) defines 
the initial buffer location where the data is to 
be stored. BC is the total number of bytes to 
be rend. BL is the burst length (default is i) 
4¢=BL<¢=256,. Burst length is the number of bytes 
to read this time through the RB. DC, if added, 
will allow separate data buffers to be linked 
(chained) by using sequential RB statements. X 
is equal to number of links to follow. R, if 
added, will cause the data to be stored starting 
in the right byte of XX(N) (default is the left 
byte). TD, if added, is the statement number to 
which channel program execution is transferred 
upon successful completion of the RB, 


44i.I- 5 
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(000 COP0 COUb GRE OO50 CADE SED URED SOND ODER SEER FO80 SEE 8000 ERIE SEND CONE GEES SORE OEE REED SOUT FETS OFS NED GIST SED DERE CUTE COED OEEE COED VERE SEER DERE OUDE SORT OHED DEEL OTD SED CObS FEDS SOES GEES DEEE BORD S008 COO) DUDE CODE F000 BEEE SOE CEEE EOET CORD SOND SEER GOTT SORE FEES BEDE CODE FOND SEED ULE FES eDER $9 


EXAMPLES) : > 40 LET CHANNEL: =7 
» 20 BSIO BSB | ‘Begin Channel Program 
> 30 RB 0,AACO),4 Read One Byte Into 
> 40 sLeft Byte of AACD) 
> 50 IN H »Done 
> 60 RSTO Execute Channel Program 
magpie 


> 40 LET CHANNEL: =2 

> 20 DB AA,1 

>» 30 BSIO BB 

> 40 RB 34,AAC0) ,4 . Read self test results 
> $0 INH | 

> 60 RSIO 


9.8 RDMAB 


OPERATION NAME: READ DMA Burst 
MNEMONIC:  RDMAB XX(N), BCE, CBLIC,RIL,TDIII 


DESCRIPTION: This statement executes the Read DMA Burst 
channel program instruction, The parameters are 
the same as those for RE except the modifier and 
DC are deleted. See HP-300 I/0 ERS for 
definition, 


4A4M14I~- 6 


Seee Gave 0900 800 SOCe BtEE CNPE SEEe Sune ERE ONES SHOE Sen EOEE SenE DUCE 


9.9 RDMAR 


OPERATION NAME: 
HNEMONIC: 
DESCRIPTION: 


9.40 RMW 


OPERATION NAME: 


MNEMONIC: 


DESCRIPTION: 


9.44 RR 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


STATEMENTS - I/O CHANNEL PROGRAM 


200S SETS SOUS BOTT COTE DOEe CETL DEED CORE ORE SEES SETS SETS BEDE SETS BOLE CORE SORE BEDE UOTE DEBE GET CORD CODD DOCS SEES CEE OTE SON FEEL FEET COED CEES COTE FEED FARE TOG DEE OGED SUES BEES COGU CONS SORE COPS CORY SENT GENT GEES GUET EINE ONO ERS SEES 


READ DMA Record 
RDMAR XX(N),BC C£,C{RIC,TDII 


This statement executes the Read DMA Record 
channel program instruction, The parameters are 
the same as those for RR except the modifier and 
DC are deleted. See HP~300 [1/0 ERS for 
definition. 


Read Modify Write 


RMWK, BN, C 
RMW K, BN, S$ 


This statement executes the Read Modify Write 
channel program instruction. K is the register 
to be modifled (O¢=K¢=!F), BN is the bit number) 
of register K to modify (COC=EBNC=!F), C will 
clear the bit and S will set it. REGISTER K is 
read, bit number BN is modified, then register K 
is written. For some registers BN has special 
meaning. See HP-300 1/0 System ERS for further 
register definition, 


Read Record 


RR MOD, XX(N), BCL, CDC=XIC, CRIC, THI] 

This statement executes the Read Record channel 
instruction. MOD is the device dependent 
modifier (O<#=MOD<=!4F), If MOD Is greater than 
IF then Read Control is used instead of Read. 
XX(N) defines the initial buffer location where 
the data is to be stored. BC is. the number of 
bytes to be read. If R is added will cause the 
data to be stored starting in the right byte of 
XX(N) Cdefault is the left byte). DCCdata 
chain), if added, will allow separate data 
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WOO Phe SERS ONES C500 HOSE SERED SEED CONE SEED 90GR C000 SEIT CEES SEES SEES CODE SEEO SEED CELE Sete SuLd EEE OED COED ELT CORE OOTP COED RDEE F000 FETE HEED COCO FOND OREF HOE HOUT GREE OOF 2OE0 CEES SEED OEDE FO0E GORE CONE EEE OODE SEED SDD S0OT FEES CEES CODE SORE FEES COED COTS BEES HOSS CREE TEES DELS SEED SO0E CONT CORE SEte S80 


buffers to be linked (chained) by using 
sequential RR statements. X is equal to number 
of links to follow. TD, if added is the 
Statement number to which channel program 
execution is transferred upon successful 
completion of the RR. 


EXAMPLECS): 


> 400 RR O,JJ(0),256,DC=2 READ 4 SECTORS. PLACE THE 


> 440 RR O,BBCO),5412,DC=i . FIRST ONE IN JJ AND THE LAST 


> 120 RR O,FF (128) ,256 » ONE AT FFCL28) 


9.42. RREG 


OPERATION NAME: Read Register 


MNEMONIC:; RREG K, XX(N) 
RREG K, X 
DESCRIPTION: This statement executes the Read Register 


Channel instruction. K is the Channel Register 
to be read (CO¢=#K<=!1F >), XXCN) or X is where the 
data is placed. If this statement doesn’t 
execute then !FFFF is placed in X or XX(N), 
Should this statement execute more than once, 
the last value read will be placed in X or 
XX(N), 


9.43 WAIT 


OPERATION NAME: Wait 


MNEMONIC: WAIT (S] 


DESCRIPTION: This statement executes the WAIT channel program 
instruction. The channel program is suspended 
until the device requests service. If S$ is used 
then bit-iS of the first word of the wait 
instruction is set. The special mode is 
described in the HP-300 I/0 ERS. 
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ate wees sane nee oper SERS BUSS FERS EERE BORD FOOD SEIS CEE ErES OSL BOLE CORY OEE Cane OFSE SEER BEES HEED ETED OTS HUET FONE COUT HOE) COND COE S100 NUTS ERED ONES CEES EERE ERED RES TERE Sete SUED HEEL SEED OPED CONF OFEY SEES OOO CONS DEES woTs ODE bene HELE SOEE TERT ORE Stee CEE Tate CHEE DOEe CTED NOE O10 BOSS seme OHS FOby 


EXAMPLECS): 


9.14 WE 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLE CS): 


LET CHANNEL: =S 

DE AA,3 

LET AACO):=!200 
LET AAC4):=4100 

LET AAC2):=!1405 
ESIO BB 

WR 8, AACO), 3 

WALT 

IN H 


RSIO 


Write Burst 


WE MOD, XX(N), BCE,CBLI £€,CDC=XIC,CRIT, 


Seek Command 
Cylinder 100 


Head £,Sector 5S 


»Issued Seek 
Wait for Completion 
. Done 


Start Channel Program 


CRJIII] 


This statement executes the Write Burst channel 


program instruction. 


The parameters are the same 


as those for RB except the TD is not valid and E 
is added to flag the end of each burst with the 
HP-IB END message. 


> 10 


> 415 
> 20 


cece ote wens cope 


> 30 


ene wees ose sore 


» 40 


cent e008 wane voee 


> 50 


> 60 


ctee mabe soe coos 


> 70 


LET CHANNEL: =7 
DR AA,4 
RSIO BB 


WE O,AACS),4,,>R 


IN H 


RSTO 


»Begin Channel Program 
Write One Byte 
From the Right 


»Byte of AACS) 


Done 
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Wet 4000 6200 eee CLES DEES OUOD Gene HOTS Cine SERS OGEE 2e00 Sete REDE Dey 


9.145 WDMAG 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


9.46 WDMAR 


QPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 
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PORE DERE ROER GOED BFFE CEEE CRED SORE BOHD EEFD BOSE SEED ERED Ge00 2O5E LOO HOLE GOES OOD COUT HOU LEDS CEE FORE BEDE DOOR HOLD OEE COLE BOOP CHOU EER EEE O0OD DEEL OROD HOSE DOUE CEES CIEE SORE SEO DEER EODE CODE COOR DOPE 2ENE SEED SEC GEES CONS BODE SOND 


mH yo 
> 40 LET CHANNEL: =2 

> 20 DB AA,1,9 Control byte is 0 
> 30 BSIO BR 

> 40 WB 31,AAC0),4 ‘Initiate Self test 
»S0 INH 

> 60 RSTO 


Write DMA Burst 
WOMAB XX(N), BC C,CBLIC,CRIC,EI1) 


This statement executes the Write DMA Burst 
channel instruction. The parameters are the same 
as those for WE except the modifier and DC are 
deleted. See HP-300 T/0 ERS for definition. 


Write DMA Record 
WDOMAR XX(N), BCE,RI 


This statement executes the Write DMA Record 
channel program instruction. The parameters are 
the same as WR except the modifier and DC are 
deleted, SEE HP-300 I/0 ERS for definition. 


HOO eebs CORD RNS nee NOES EDET MEN femiD Feet Fone PIROD Em BEE HOES Pee 


9.47 WR 


OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 


EXAMPLE CS) : 


STATEMENTS ~ I/0 CHANNEL PROGRAM 


G0E? 9008 BOTS CORD DEES SES ObEP BOLE SONS FEF DEES BODE DEES SETS COTY SeTe GOES OTE BFE BEE LORD CODD OOED 9000 REGS S0ED BEND EETT LOTT COTE SEET BEDE COED GEES HOUT DEEP EEEE BEDS OTE GREE OEE bEED S060 EEF BORE DUNE SUED eOES OEID BEEY OO BEDE euTe Sone 


Write Record 
WR MOD, XX(N), BCL, CDC=NIJ[, RI] 
This statement executes the Write Record channel 


program instruction. The parameters are the same 
as those for RR except the TD is not valid. 


> 10 WR O,JJ (0),256,DC=2 .WRITE 4 SECTORS. GET FIRST 


> 20 WR 0,BBC(0),512,DC=i . FROM JJ, THE NEXT TWO FROM BE 


Cent etee ence cate 


> 30 WR O,FFC( 128) ,256 » AND THE LAST ONE FROM FFC(128), 


9.48 WREG 


OPERATION NAME: 
MNEMONIC : 


DESCRIPTION: 


9.49 WRIM 


OPERATION NAME! 
MNEMONIC : 
DESCRIPTION: 


Write Register 


WREG K, XX ¢N) 
WREG K, X 


The parameters are the same as those for RREG, 


Write Relative Immediate 
WRIM Z,(X] 


This statement executes the Write Relative 
(Immediate channel program instruction, Z is the 
displacement from the next instruction of the 
channel program (-128¢=Z¢s127), XxX is the data 
to write into the channel program at that 
location, If Z is negative then X is not used, 
The constant used is what is already in the word 
at WRIM execution time (See HP-300 I/0 ERS for 
further details). 
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Wee ents e000 SORE CORE POSE CFE LOAF BEES SEES CFOE ODED SINE ODE COE EDO COT BOPP GeED SEES SOEe SOOT FONT FEET CORE CEES CEO BOSS FEMS CHEE OFET DUPE FIRE DEOL COE BEE0 BOOP FOEE HEED HEDE DENT WOES HOLE TOES DEN SOOT FOES FETE COED HORE SFOS BODE CONE FOES ONE SORE LEDGE EOES BEES cote BEES GOED EDED DEED SPER SObE SEEe hee Lees Cote 


EXAMPLE CS): > 400 JUMP 110 .Jump to 130 Second Time 


te08 ete acer sone’ sees 


> 410 WRIM -3,4 Change 100 to JUMP 130 


e000 wees onee ates case 


> 420 JUMP 100 


C000 sone sacs sees ence 


> 130 INH 


Gene nee ones e0ee ecee 
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2008 OBEs MbOE 2880 Bete S500 DEED DoDD EEE HEE EECE BEES BEES OHSS BEES COED SHOE CORD DEDE D4BE SEER EFRD CEOS DERE SEE EEG PETE HOES BEET OPES DEES Smet SEED BEEY SERS BEES BOLE SOFE BEES COSY OTES BEES FETS SERS OOOy FERS CUES BENE COED CEE STH BEES SEES FETS CEES SEEN CIE BEES CUED SObE wae BOOS OER Cote FOFE BEDE NETO BOOS DEES HYEE 


40.0 FUNCTION STATEMENTS 


This section defines the statements used in creating programmed 
functions. 


40.4 ENDF 


OPERATION NAME: End Function Definition 


MNEMONIC: ENDF 
DESCRIPTION: This statement terminates a Function definition. 
EXAMPLECS) : See FUNCTION statement. 


10.2 GETNAMEDATA 


OPERATION NAME: Get data found offset from NAME parameter 
MNEMONIC: GETNAMEDATA NAMEx, offset, variable 


DESCRIPTION: Provides access to the memory location offset 
from the pointer found in NAMEx. If a buffer was 
passed as the NAME parameter then the element of 
the buffer plus offset is stored into variable. 
If a buffer was not passed then an AID execution 
error is reported. 


EXAMPLE CS) : iG DB AA,100 
100 FUNCTION DOIT NAME 


i140 GETNAMEDATA NAMEL,5,A .Store contents of AACLS) int 
120 GETNAMEDATA NAME1,-3,8 Store contents of AAC7) in 


200 ENDF 


500 DOTT AACIO) 
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090B DERD 8000 ONG CSUR LETS SUOE ODE EROS VEER HOSE 0900 2008 EEE O00) HOUR RUDE 2005 OEEH ZECP BNEE HOSE FEE NFDE RODE FNOE EONS AUST NODE F222 5IE9 290D FEES AONE DEED HENS EODE FUSS 508 TERE HELE HOEY DEE DOTS ONES AEDT BEE FOOD BEOD BONE DUET DEE DEM BEDE FOE SERS ONDE SORE SORE 2802 FONE REGe S000 EDS WERE BETO Sent SENS NEO eee 


40.3 GETNAMEINFO 


OPERATION NAME: Get NAME parameter information 


MNEMONIC: GETNAME INFO NAMEx £€,X10,Y10,Z1 
DESCRIPTION: Provides the identity of the NAME1/4 parameter 
including: 


Type~ simple varilable,reserved variable ,data or 
string buffer. 

Name~ A through Z or position of reserved variable 1 
AID Reserved Variable Table, 


Element~ number of the buffer element passed, 
Length Size of the buffer in words. 


X, if included, is stored with the following 
information: 


0 i 8 iS 


SGP WHOS 0868 F000 CORE HOOT ROLE BOLE HELE HORE OHO BELT FOP SEES COON FOE ENED 2E8g LODE DERE EEE FORe LOET TEOE KOT Shue NEY SAUL DEES BENE FORE fade FOER FOSS DOTE ONDE FOES cote 


itype i} i name i 


4 200t 0UOF BUDE BO00 POET FETE SEDe UDET BNDT DONE FOEE DEES GREE SEER OFEE DRE SREP sONe BEES DEED BE0G OPED AEE FEE HOHE SENG HEED DEED Cote BRED 0900 SNOT FEET cOeE BERD oNEE Sune Cee é 


type=0 for data buffers (CAA~ZZ) 
1 for string buffers C&AA~-4ZZ) 
2 for reserved yarilables (MAXMEMORY~FILELEN) 
3 for simple variables ¢CA-Z) 


name=%104 for A,AA or AAA through 4432 for Z,ZZ or &ZZ, 
If type is a reserved variable then name equals 
the offset from the first reserved variable in 
memory (See AID LIST R Command for their order), 


Note: if a NAME parameter is not passed then X is 
defaulted to that name parameters Reserved 
Variable, 


Y, if included, is stored with the element passed 
if the NAME parameter was a buffer else -1, 


2, if included, is stored with the length of the 
buffer passed in NAMEx. If a buffer wasn’t passed then Z is 
Stored with ~4, 


EXAMPLE (S); 
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0008 0008 CORD 9008 DORE DONE 9004 TONS SENG ESS FRET BODE O00 S000 8500 COLE SUED BEDE BEDS VETS Fb00 BOFE BORE DENO DEED BEND LONE B22G DERE ESED ONCE UGDT BOE 2505 DONE JUNE 3840 O96) DEED BONE BODE HOE 2000 OED BUDE HORE DOTS FOE0 LOEE SOR) RENE ERED DDEG DEEN ONE DEED DORA OED FONE DONE FOND DONE O900 BOO 2000 Seee 


10 DR AA,100 

100 FUNCTION EXAMPLE NAME1,NAME2 ,NAMES ,NAME4 

4140 GETNAMEINFO NAMEL,A,B,C .A=KZL04 (CID) , B=SCelement) ,C=100Clength) 

120 GETNAMEINFO NAME2,D,E,F .D=0(default parameter) ,E=F=-4 

130 GETNAMEINFO NAMES,G,H,I .G=42140132¢ID) ,H=I=-1 

140 GETNAMEINFO NAME4S,J,K,L .J=#%Z10000S5(Sth Reserved Variable) ,K=L=~4 

S00 EXAMPLE AACS),,Z,STEP .See FUNCTION EXAMPLE 

40,4 FUNCTION 

OPERATION NAME: Funetion Declaration 

MNEMONIC; FUNCTION name Cparameters] 

DESCRIPTION: Defines the entry point and parameter format of 
subsequent function calls, The function 
capability enables the user to create 
quasi~statements with an unique name and 
parameters where! 

name= maximum of 8 alpha characters. 
parameters= Pn £€,Pn.,....,Po] 
where: | 
P= NAME for a variable or buffer 
passed by name, 
VALUE for a constant, variable or 
buffer passed by valve. 
n= ordinal numberX of P where i is 
the first parameter of the 
NAME or VALUE type and i¢=n¢=6, 
The following ruleskk govern FUNCTION use: 
(4) Calls to the FUNCTION Statement must insure all parameter 


types are matched. Any parameter may be defaulted i.e. 
excluded, except the NAME type when it’s used as a read/write 
bufferte.g. RR O,NAME1,5). Defaulted VALUE parameters are 
assigned the quantity 0 and defaulted NAME parameters are 
assigned to the Reserved Variable bearing their name, 
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came 2050 ROE SOND enme AONE CEN HERD SEED ObEE EEE LODE BOOT LEED DOLD SEED OEDE PRED CODE BEDE CORD BEES SECS DERE EDEE COLE BEL SEES SEES ONE EDEL SEDE SEED SEE OOES SORE COOL ODES SEES NURS SDE CEEL BORE SEED COOH SEED HPES COEE CDED BORE SEEY DEE ENEE F000 FORD HITE FOOD BODE DOLE LEDS vEbD EetD HEEL CEab GOED OFEE SOF HOES OED Sone 


x Example: VALUE’, VALUE2,NAMES , VALUES ,NAME2 , VALUE4, NAMES ,NAME4 


KK See the respective examples on the following pages which 
display rule usage. 


(2) Function calls may not be input unless the appropriate 
FUNCTION Statement is already in the program, If a FUNCTION 
Statement is deleted any calls to it render the program 
unexecutable and a LISTing of the function calls will yield a 
warning message. 


(3) A FUNCTION calling a FUNCTION is allowed but Limited to the 
amount of space available to the user program (i.e. every 
FUNCTION call places ao 13 word information block into the 
user area and each ENDF Statement removes just one 
information block). 

(4) The FUNCTION Statement may never be executed in line, i.e. it 
must be called, and a branch into a FUNCTION-ENDF Statement 
sequence during execution will produce an error. 

(5) ALL AID Statement ,Command, Reserved Variable keywords (e.g, 
LET, TEST,etc.) and the buffer names AA to ZZ are reserved and 


an attempt to input a FUNCTION statement name using such a 
keyword will result in an error. 


Limitations using functions: 
(a) Use of name buffers, i.e. NAMEL-NAMES, is not allowed in 
AID Statements that use buffers without elements, e.g. 
BSIO, RSTO, DEB, etc. 


(b) Indexing of name buffers is not allowed, i.e. NAME1(X)., 


Mees CO0e SORE F9EE one SHED COTS COED BEEe CAGE WEEE FETE SEES CORE UDEE FOE SOLE FORE SEED CESS HOES O5Ee SEED SUSE SOE OFUR PEED SOND SOE CHte COEe 


> 40 FUNCTION ADDEM NAME4, VALUES, VALUE2 
> 20 LET NAME 1:=VALUEL+VALUE2 
> 30 ENDF 


>400 ADDEM A,7,2 ALE74+2 
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R008 Sete Meee ene Cote epee FERS Shes COEF HORS BED SENS EEO BaEY 8EC0 OOS CORD S0OE CEE COE DEE ORES CEEE ONES BOEe SEND Sate SEES SEdS SOEE SOEs SOUT GEES REDS LEDS BEES SORE CORD BETS COED COTE Sted BORE BONS CORE EEE OFDS Stee HEED EEET SONY OheD SERS LODE CHES OO00 SOD CUED OEE SON Cane StE CINE OED ROSS TUES StES Dnt Senn tO0r 


COP) eons WEED CONO bond aman name Sons omnes SOs Cott Cece Eyer SECe eee FeOy CEUD SEES EUEE BUND Cums BSCS Obes UENO FOOD SEND TODS CEES COED OOSE S0e0 


> 40 FUNCTION ADDEM NAME‘, VALUES, VALUE2 
> 20 LET NAME‘: =VALUE4+VALUE2 

> 30 ENDF 

>400 ADDEM 4,7,2 


2410 RUN 


tee e00e tte OPED Sens S900 ReRe ORNS KODE COTS SEED EET GENE S108 BETS S000 FOND CoE CEES Comt CORE COED BEET OOEy BETS CLES EENY Sous CUED COED BONE Pane 


000 BARS ante COFE CoES FES LORS FEES RERe COON SOE SENS CEES SETE COTE RISE SREY COEE BOTS SEDT ENED Gone CurE ete StTe Chen OOED BIGH WHEE PEDD OOE0 SORE CORD CaRS COTE SOOT LERd EOI TEE CeTE Hen OOOE CODE 


Sees See Sens S058 came gece Sune LER) SORE SERS SHEE S000 CEES CEES SORT COTS OES SEES Cues SEE HERE SEED DEED SOLE ERED SEES SES CORP ERED Seen Suse eEee seeR 


> 40 FUNCTION GETSR NAMES 
> 20 RSW NAMES 
> 30 LET NAME1:=NAME4 AND !7F 


> 40 ENDF 


>400 GETSR AACO) 


C000 G80 SObb OOE0 SOEs SOrd COTS COEe BEDE ORES OPER CERT COED SORE SERS HERE LEEY ROR OF00 SEE SEES ChED SEES EERE CONE CERE TETD DERE O10 SERe GERD tte Cote CIETY ouDe 


(Assume this is the first Statement input) 


> 10 GETSR AACO) 


a 


KX AID Entry Mode Error xx 
Tllegal parameter, type or input 
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> 40 FUNCTION GOING NAME4,NAME2 
> 20 ENDF 

> 30 GOING A,B 

> 40 DELETE 10 

>» 40 LIST 


20 ENDF 


000 MnOe cote tore Cnee CNET S600 


S089 MANE S988 GObe WHEE OREO GENE HONE CORT CIEE ANGE BOON FORE HOEH ENED THEO DEAE HED RODE FdOe OHER DEEL BRET COE OORT 1008 SOOT SORE FEET MIGE SORE FEDF Gage HORE REDE I80O C9tR CORR CONE ope enbT H608 Doge S00? 


> 40 
(Note~ Statement 30 is supposed to be GOING A,B 
but has no significance since Statement 
10 was deleted. Statement 10 must be 
restored with a FUNCTION Statement to 
LIST or execute normally) 


Example of RULE 3 ¢ correct way ) 


$008 C90E WEP SUED SUCE CORE SURE SIGE DEEP SONS HUET DETR ott SEO SORE e0ED EyRE SET SORE BEES CODD OFEE ROUT COD BNCT GEE COUT SERS BODE SOED OFER SUED FEET 


(Demonstrates a FUNCTION calling a FUNCTION) 
? 40 FUNCTION ADDEM NAMES, VALUES, VALUE2 


otes ayes core comm 


> 20 LET NAMES: =VALUE1+VALUE2 


 amstadladeonid 


> 30 ENDF 


> 40 FUNCTION GETSR NAME4 


> 50 RSW NAMES 


> 60 ADDEM NAMES, NAMES ,4 » Add 4 to gw. reg, 


ston pee nen ca 


> 70 ENDF 


2200 GETSR A Get sw.reg. and add 4 to it 


(Demonstrates a recursive function call) 


> 10 FUNCTION POWER NAME4, VALUE’, VALUE2,NAME2 


N00 core wore euee 


> 20 IF VALUEG<4 THEN 50 
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> 30 LET NAME2:=VALUE2!:=NAMELKVALUE2, VALUES: =VALUEL~4 
> 40 POWER NAME1,VALUE1 , VALUE2 ,NAME2 
>» 50 ENDF 


200 POWER A,7,1,B .Get A to 7th power and put in B 


ete once onte onde 


of RULE 3 ( incorrect way ) 


{00 HORE c00e 9600 ENED OEE D000 CER GHEE ONDE SO00 BLED LENE SEER AEEE ONES OOD) LEED F008 GORE ERE HOSE OERY EDD CRED CONN HOEY SO00 DESO COOL atEO etEe Coen suEE CEER 


Example 


9 Me CO0e PONS cone ote pase sey cone 


Example 


ee OOP Ube cone Gow seED corr ate 


> 30 ENDF 


>100 FOREVER A 


>410 RUN 


soot egos cess sqee 


KK AID ERROR in Statement 20 x 


9008 G00 O90 SEED Eras COPS DONS FEE UNDE TOEE BEET ONES LODE FOEE TEND OEE EOEE FEDE CgES DEDe MEDD SegR OOtE HOtt EDET 


(Statement 20 will build 43 word blocks until no more 
user space is available at which time the program 
will abort) 


of RULE 4 ( correct way ) 


S00 0000 C0Od SEED COED SEEE SETS BENS 2000 OFE0 OOEE B00) OONS SEED SETS SEE OED EOE OBIS ONE BIBL SEER ONTO OFNE sone 


> 40 GOTO 300 =. Branch around Functions 
> 20 FUNCTION POWER NAME1, VALUES 


2290 ENDF 


+300 .Start of normal program 


of RULE 4 ( incorrect way >) 


Otte SOO COee COLE O9T0 Hote SOE0 FEET O00 SHE) REED SOR BOLE SEES HOEY DEED CNET CON DOES GETS FEDS FUE 0000 GOES CORE one COED 


> 40 FUNCTION POWER NAME4, VALUES 
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> 20 LET NAME: =NAME 1 XNAME 4 
> 30 ENDF 
> 40 RUN 


Kk AID Execution Mode Error in Statement 10 *x 
FUNCTION Statement cannot be executed in-line 


Example of RULE S ( correct way ) 


POOR GNF COED RROD EOD S08 HED CORE HEEE COLE CORE SENT HERS OOD REED S200 CORE EEET FORE SEED eEE CRED cOET HORE SEED COED CdEE CODD OuDE BHTD Cate FORD EEE 


> 40 FUNCTION TESTX NAME .TESTX is valid 


Example of RULE S ( incorrect way ) 


{0d GATE CUEO F000 OPEL OATH SORE SORE CONE CORE HERE COTE LEED OODD BORE EDU COEF COE7 CONE FET HORE CEES ONES EOS EEED DEED SORE SO20 GENE SOER SaEy LENS BEES eoTe Cote 


> 40 FUNCTION TEST NAMES 


a 


xx AID Entry Mode Error *x 
Invalid FUNCTION name or reserved keyword 


Practical I/0 application 


CARA WORE AAPD CORD OOOH GREP VED BENE LOUD FUER FOOD FEIT NAEP SEDO EEE BETO LEED S2G0 SOE DEES BFE EET GRRE CRED COR 


>400 FUNCTION READDATA VALUE, NAME’ ,VALUE2 , NAME? 

440 .Reads data into buffer NAME with modifier VALUE. 
1420 . and length VALUE2 and compares the read 

41430 . data to buffer NAME2 

>140 INIT -Intialize Device 

>450 BSIO AA. Build Channel Program 

2460 RR VALUES ,NAMES ,VALUE2 Read record 

470 RSTO » Execute Channel Program 

(3480 CB NAME ,NAME2,VALUE2 Compare buffers 

34190 ENDF .End of READDATA 


2500 READDATA 0,AA(0),256,BB(0) .Get and test data 
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Cane ance Snee Seen Gone Cree SEES BODE SESS BORE GOES VOLE FEEL FOES 2E08 TEE BEET BEFE CE00 SET BEE EOFS OEE FEDS OUST BEES CORD CODE OORT EDET COVE SECT SuED GEES EIS LEED SEDE COPS OED) GOES OLS aHEE OEE COE EPEE COED BENS EOEE ERED OURS GIRS CEES S505 BEES EDEE ERS COPS PERS EDCS CORE GOED CEDE SEIS GENS WEES SOOO HOO SEEy Ered HOEY 


»Si0 IF INDEX=-i THEN 550 


S20 EPRINTK “Compare Error! Bad Data=";AACINDEX); 


>530 PRINTEX " Good Data=";BBC INDEX) 


>540 EPAUSE 


550 .Continue Program 


10.5 SETNAMEDATA 


OPERATION NAME; 


KNEMONIC: 


DESCRIPTION: 


EXAMPLECS) : 


10 


100 
440 
120 


300 


Store data into a NAME buffer element 
SETNAMEDATA NAMEx, offset, variable 


Stores the data in variable into the buffer 
element plus offset passed as a NAME parameter. 
If a buffer was not passed an AID execution 


error will occur. 


DB AA, 100 


FUNCTION DOIT NAMES 
SETNAMEDATA NAMEL,5,A .Store contents of A into AACS) 
SETNAMEDATA NAME1,-3,8 .Store contents of B into AAC7) 


t 


ENDF 


DOIT AACiO> 


44iji- 9 


118 peed Rene Bees meee eone sem ue ser 


KEKKKKKKKKKK 
KSTATEMENTS 
KKKKKEKKKKKK 
MNEMONIC PARAMETERS 
ACSSIGNI bufled(, (rpt)),data {,...,.,datal 
ADDRESSOFF none 
ADDRESSON none 
BUMP Cysuppress cr/1fifHold passcount inc] 
BCEIO) bufl,copy number] 
CB buf(element) buf (element), length 
CHP data bytei [,,....,,,data byteB8] 
CLEAR {control bytal 
’ any ascii string 
CPVA data buffar (element) 
COPY buf (xcopy number) 
DB buf, lengthl initialize datal 
DELAY delay count in 86 us Increments 
DSJ label{*rptit,.., labelf{xrptiilsyret. byte, dest] 
ENAGLE none 
END none 
ENDF none 
EPAUSE none 
EPRINT [Xno pause] 
string data,variable or space ctfjor,]f..] 
ECSio) none 
FILENAME string buffer(ele){,sector offset] 
FLOR] assignment expr [STEP expr? UNTIL €orTO) expr 


GETNAMEDATA NAMEx, 
GETNAMEINFO NAMEx, variable, varinble, 


GCOSUBI 
GOTO 


INIT 
ILNPUT} 
INPUT 
IOCL 
IOFF 
ION 
SUMP 
[LET 
LOCATC 
LOOPTO 
LPOrF 
LPON 


QUICK REFERENCE FOR AID USERS 


label 
label 
none 


offset variable 


returned word destination 


expr {sp.op. exprisp.op. exprjJ] THEN label 


sane as IF 


Runfor Halt3£,cpya word pntril,interrupt code] 


none 


Varijablel,......,variable] 


data buffer (element) 
none 

none 

none 

label 


variable 


variable:={,..variable:zlexpr£f,,....0) 


((copy number),1] labell (offset)1 , destination 


statement 
none 
none 


JUL 46, 
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OPERATION 

BUFFER ASSIGNMENT 

SET R/W WORDS BIT4 
CLEAR R/W WORDS BIT4 
INCREMENT PASSCOUNT 
BUILD CHANNEL PROGRAM 
COMPARE BUFFERS 
COMMAND HPI 

CONTROL -CLEAR 

COMMENT ONLY 

SET CPVA BUFFER 

COPY CHANNEL PROGRAM 
DEFINE BUFFER 

DELAY 

DEVICE SPECIFIED JUMP 
ENABILE ERROR PRINT 
TERMINATE PROGRAM 

END OF FUNCTION 

ERROR PAUSE 


ERROR PRINT WITH PAUSE 
END CHANNEL PROGRAM 
SET FILENAME POINTER 
START FOR-NEXT LOOP 
GET NAME DATA 

GET NAME 

PARAMETER INFO 

GO TO SUBROUTINE 
UNCONDITIONAL KRANCH 
HALT CHANNEL PROGRAM 
DEVICE IDENTIFY 
CONDITIONAL BRANCH 
CONDITIONAL BRANCH/NOT 
INTERRUPT 

INITIALIZE CHANNEL. 
INPUT DATA 

VARTABLE LENGTH INPUT 
1/0 CLEAR 

INTERRUPT SYSTEM OFF 
INTERRUPT SYSTEM ON 
CHANNEL PROGRAM JUMP 
ASSIGNMENT 

FIND INSTRUCTION 

END OF LOOP 

PRINTER OFF 

PRINTER ON 
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NEEXTI label 
NOCHECKS None 
PAGE none 
PAUSE none NON-ERROR PAUSE 
PPLRINTI same as EPRINT NON-ERROR PR W/ PAUSE 
PREINT] String data,variable or space countlsor,3]£..] NON ERROR PRINT 
PRINTEX same as PRINT ERROR PRINT 


END OF FOR-NEXT 
STOP CHECKS 
PRINTER PAGE 


PROC [No proceed} I/O WAIT CONTROL 
RANDOM {Carquement),1] variablef,...,variablel GENERATE RANDOM NUMBER 
RB modifier ,buf(e), byte countl, (burst length]>)> 

{,(€DC=data chain Llinki£,CRight byte}>>>>>>>> 

{,Clabel€td}1{,€Pause after burst]1131 READ BURST 
R DMAB bufCe), byte count£ ,fburst length, {Right bytel>> 

[ llabel(€td311] READ DMA BURST 
RDMAR bufied),byte count£, (Right bytell,label€td31] READ DMA RECORD 
RDRT drtword number ,destination READ DRT DATA 
READCLOCK variable READ SYSTEM CLOCK 
READFILE buf(element) ,length READ FILE 
RLETURN]I none RETURN TO GOSUE 
RIOC reaister number ,destination£ ,control byte) READ T/0 CHANNEL. 
RMSK destinationCvariable) READ MASK 
RMW reaister number,bit number ,ClearCor Set} READ-MODIFY-WRITE 
ROCL destination{variable) CHANNEL ROLL. CALL 
RR modifier ,bufte) byte countl£ ,£DC=data chain link1> 

{,€Right bytell ,label€td31)} READ RECORD 
RREG register number ,destination(Cvariable} READ REGISTER 
RSIO Coufl,€Ccopy numberJI£,label]] RUN CHANNEL PROGRAM 
RSW destination(Cvariable} READ SWITCH REGISTER 


SECTION Section number ,label START OF SECTION . 
SETNAMEDATA NAMEx, offset, data STORE NAME DATA 

SMSK mask value SET MASK 

SPACE line count PRINTER SPACE 
SPACESOFF none NORMAL NUMBER PRINT 

SP ACESON none LEADING SPACES ON # PR 
STARTCLOCK clock increment START SYSTEM CLOCK 
SUPPRESS none SUPPRESS ERRORS 
UPDATEOFF none SET R/W BITS WORD 4 
UPDATEON none CLEAR R/W BITS WORD4 


WAIT (Set bit 1591 CHANNEL PROGRAM WAIT 
WE modifier ,bufle), byte count£€,fburst length3>>>>> 

C(,€DC=data chain linkiIL,fCRight byteI1>>)))> >> 

C,fCEet Ffiagif,(€Pause after burstj]]11] WRITE BURST 

WDMAB buf(e),byte countl£, [burst Length])>>>)>>)>))>> 

{, {Right bytel{,CEot flaqi]) WRITE DMA BURST 
WDMAR buf(e), byte countl,Right bytel WRITE DMA RECORD 
Wroc register number, data WRITC I/0 CHANNEL. 
WR modifier ,buf(e), byte count£, [DC=data chain link] 

{,Right bytel] WRITE RECORD 
WRIM offset{ ,datal] WRITE RELATIVE IMMED, 
WRITEFILE buf (ele) ,length WRITE FILE 
ZEROESOFF none NORMAL. NUMERIC PRINT 
ZEROESON none LEADING 0’°S ON # PRINT 
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MNEMONIC 


CREAT. 


LF 
LOr@sTy 


LOAD 
LOOP 
LOOPOFF 
MCODIFY) 
PURGE 
REN 

RST 

RUN 
SAVE. 
SEPR 
SEPS 
SET 
SNPR 
SNPS 

SO 


TEST 


PARAMETERS 

filename ,lenqth in sectors 
labell/labelJ 

none 

none 

none 

none 

none 

none 


[parameteril[,..,parameter3] 


increment value 
none 
CPRINTER] 


[PRINTER] {data type lor%}1>>> 
[Reserved varCor CCpasscount} or Variable or 
BufferJ1£ ,parameteril(/Cor , i] fparameter2d> 


{/parameter3] 
filename 


same as LOOP 
filename 
[renumber value] 
none 


{parameteril[,..,parameter3] 
filename [fCrevision €00,00)31 


none 
none 
statement number 
none 
none 
none 


OPERATION 

CREATE FILE 

DELETE LINES 

ENABLE ERROR PRINT 
ENABLE ERROR PAUSE 
ENABLE NON-ERROR PRINT 
ENABLE NON-ERROR PAUSE 
ERASE PROGRAM 

LEAVE PROGRAM 
CONTINUE PROGRAM 
CHANGE STMT INCREMENT 
LIST COMMANDS 

LIST FILES 


»>> 
>> 


LIST PROGRAM/DATA 

GET PROGRAM FROM DISC 
SET LOOP FLAG 

CLEAR LOOP FLAG 

MODIFY STATEMENT 

PURGE FILE 

RENUMBER PROGRAM 

RESET FLAGS 

RUN PROGRAM 

SAVE PROGRAM ON DISC 
SUPPRESS ERROR PRINT 
SUPPRESS ERROR PAUSE 
NEW STATEMENT NUMRER 
SUPPRESS NON-ERR PRINT 
SUPPRESS NON-ERR PAUSE 
STOP STREAMING 


f+ or -If€l€ section numberI[/Cor,310...€/Cor,31>>> 


section numberlJl]{for ALL] 


SELECT TEST 
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KKKK KKK KKK KK KKK KK KKK 
KRESERVED VARIABLES 


MK RE KK KK KK KK KKK 

MNEMONIC CONTENTS 

BADINTP channel/device number of device that interrupted illegally 

CHANNEL channel nunber of davice under test 

CONCHAN channel/device number of console device 

DEVICE device number of davice under test 

FALSE 0 to designate a false value 

FILE INFO Bit Owmprotected (if 4), Bit G/iiscliass, Bit 12/1S5=type, 

FILELEN Length of file deciared in FILENAME 

GOP ARAMS/3 first,second and third GO parameters 

INDEX CH. statement result C-isgood CB else elament where CH failed?) 

INPUTI.EN length (in characters) of last operator input during INPUT 

MAXMEMORY remaining memory left to user 

NAME4/6 FUNCTION name parameters, 

NEWTCST true if TEST X entered by operator else false 

NOINPUT true if non~error print is not allowed 

NORESPONS O@AID will handle bad response from 1/0 else 

store it with the value of I/0 error 

OFFSET number of stats (+or-) from GOSUB to return to on RETURN 

PASSCOUNT number of program passes (determined by BUMP executions) 

RUNPARAMS /3 first,second and third RUN porameters 

SECTION current test section in execution (or lnat executed) 

SECTIONS1/3 bit mask for test sections to execute (itok to execute)! 
CSECTIONSi=tests £-46) CSECTIONS2=tests 17-32) 
CSECTIONSS=<tests 33-48) 

STATENUM statement # of most recently executed FUNCTION-calling 
statement, 

STEP current step number (determined by LET STEP:=number) 

TIMEOUT during channel program timeout allows “S secsk(TIMEOUT-1) delay 
before error (if negative then no timeout is desired) 

TRUE ~“{ to designate true value 

VALUES /6 FUNCTION value parameters. 
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XOPERATORS* 

OOK KK KOK 

OPERATOR MEANING 

«> not equal to 

i: equal to Caquivalance test only} 

« less than 

> greanter than 

da greater than or equal to 

% multiply 

aD addition 

“ subtraction Cor two’s complement addition) 

/ divide 

$m asslonment CLET var: sexpressions 

OR logical OR 

NOT one’s complement 

MOD remainder of divide (5S MOD 3 equals 2) 

AND logical AND 

XOR logical XOR 

LSt Logical shift left Chit 0 lost, 0 into bit 15) 

1, SR logical shift right Chit £5 lost, 0 into bit 0) 

ASL arithmetic shift left Cbit 0 snved,bit 4 lost, 0 into bit 45) 
ASR arithmetic shift right {bit 0 saved,bit 0 to bit L,bit 15 lost) 
CSk circular shift left Chit 0 to bit 15, nothing lost) 
CSR circular shift right {bit 45 to bit 0, nothing lost) 
EQ special operator Cequal tod 

NE special operator {not egual tod 

LT special operator Cless than} 

(aT Special operator Cgreater than) 

IE special operator Cless than or equal to} 

GE special operator €greater than or equal to) 
KAKA KKK KOK K 

XMODIFY INFOX 

FORO NCR KK KK KK 


CONTROL CHARACTER 


ee ete er 


PYMOH wa 


MEANING 


Replace with following characters 

Insert following characters 

Delete this character 

Exit (delete old statement, add new statement) 
Join (save old statement, add new statement) 
Abort (current edit statement unchanged) 
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SECTION 442 


LOMAP 
CINPUT/OUTPUT MAP) 
PROGRAM 


EXTERNAL REFERENCE SPECIFICATION 


Proaram Revision: OQ4,XX 


References: 
Subsystem Summaries [Handbook Sections 200-299) 
HP-IE Summary CHandbook Section 416141 
HP-IB Tutorial f[Handbook Section 761] 
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The information contained in this document is subject to 
change without notice, 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE. Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse~ 
quential damages in connection with the furnishing, per- 
formance or use of this material, 
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Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- . 
nished by Hewlett-Packard, 


This document contains proprietary information which is 
protected by copyright, All rights are reserved. No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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4.0 INTRODUCTION 


i.4 General 
The TOMAP utility has three purposes: 


Cid It provides a display of the system physical I/0 
configuration 


(2) It checks out the basic hardware I[/0 system 


(3) It provides Identify » Remote Self-Test, and HP~IB Loopback 
device tests. 


All channels on the IMB are identified, The HP-IB Identify 
feature is then used to obtain the ID codes for the devices 
connected to each GIC., A brief description of the channels and 
devices is displayed in a table. 

This identificatien process tells you that: 

(4) the I/O system CIMB and HP-IBs>) is fundamentally working 


(2) no two channels and devices have the same address 


(3) the expected channels and devices are present and correctly 
configured. 


In addition to the I/0 configuration display, TOMAP has three 
selectable test sections available to the operator when in the 
optional mode. This optional operating mode allows you to 
perform Identify, Remote Self-Test, and HP-IEB Loopback tests on 
geelected devices. For intermittent problems, any one of these 
functions can be looped, 


This program is written in the AID language. 


1.2 Required Hardware 


Hardware required to run the Diagnostic/Utility System. CDUS) 


4.3 Required Software 


Dingnostic/Utility Package flexible disc 
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2.0 TEST LIMITATIONS 


Channel identification depends on correct operation of the IMB 
and the CPU’s ability to read the Configuration Registers on 
channels. This involves circuitry on every board connected to 
the IMB -- not just those explicitly involved in the transaction. 


Device identification depends on correct operation of the HP-IB 
“~~ this involves circuitry in every device connected to the bus, 
not ~ just the controller and device being identified. 
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3.0 QPERATING INSTRUCTIONS 
Kring up DUS 


i 
i] 
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t 
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; Program Initiation State 
; ~ DUS starts program 
: ~ Program emits title message 
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i program i 
i ready (Resets all options 


i except TEST & LOOP) 
y i >RUN EXIT 


AO0s OOPS HEDe O90E BUDE SED BPG DERE BORE HEEF COLL OREL FONT SiGe STEP SHEE SADE ERE HORE CODD OFEE AEED HOO? DDET HONE E200 FOES CEED MEEE CONE BENE 2080 GORE TERY Gone HiDE FRE IhGe HIE to0e HOLE E8Ct BORE NEDO ODED REED CLOT FE0R tHEH 
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> ([Program Pause State] 

Select options: >xTEST 
>SNPR, etc, 
>9LOOP, LOOPOFF 
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i + >GO + - ~ 

i i (resumes i i 

‘ i execution?) i; error i ATTENTION 

i y i pauge i or Control~¥ 
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Program Execution State 
m Executes program per default or TEST options 
~ Emits messages per SNPR, etc. options 
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i } tests done - 

H H i to first 
i H i selected 
; y i test 


NO-~ LOOP on 2 --YEGs--e nnn) 


+ GO 4 - optional Test Sections 
GO ,4 ~ printer output 
G0 4,4 ~ optional Test Sections and printer output 


ane ee ee 


KX Requires security code 


Figure 3,4 ~- Program State Diagram 
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Hefore running thie program be sure that the physical 
configuration Cawitches on the frontplane) matches the logical 
configuration required by the operating system. 


There are two modes of operation available for this diagnostic 
program ~- the standard (default) mode and the optional mode. 


To operate in elther mode, follow these steps! 
(1) Bring up the Dingnostic/Utility System (DUS) 


(2) The DUS prompt character (:) is displayed, (DUS Entry State 
in the State Diagram, Figure 3.4) 


(3) Respond ’ITOMAP’, to load the IOMAP Program. 
(4) The program displays its title message and prompt character 
27>? (Program Pause State in the State Diagram, > 
"TOMAP REVISION XX,XX" 


Enter *GO’ to continue 
7GO,4? to continue with printer output 


*GO 4? for Optional Test Sections 
7GO 4,41’ to run Optional Sections with printer output 


(7LO? to List Commands) 
> 


The next step (step S) depends on whether you want the Standard 
Mode or not, 
3.4 Standard Mode 


(S$) If the standard mode is to be executed, enter ’GO’ Cor *GO,4? 
to get printer output). 


The standard mode is defined as follows: 
(a) Execute only the I/O Map (Test Section 4) 
(b) Display error, information, and prompt messages. 
(c) Pause on errors and prompts. 


TOMAP will display the system I/0 configuration table then 
terminate. 
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3.2 Optional Mode 


In addition to the 1/0 confiquration display, IOMAP has three 
selectable test sections available to the operator, Entry is 
done when in the optional mode or entry into these test section 
can be accomplished via the AID “TEST? command. The AID *TEST? 
command requires knowledge of the security code. Each of the 
optional test sections will request the operator to enter a 
channel and the device number. After the operator enters a leqal 
channel and device number and execution of the selected test 
section completes, the operator will be returned to the entry 
point of the selected test section. The request for a channel 
and device number only occurs on the first pass through the 
optional test sections. Therefore, entering the AID ’LOOP? 
command, does not force the operator to re-enter the desired 
channel and device number as ench pass is made. 


(S) To enter the optional mode, enter ’GO 4’? or *GO 4,47. In 
response to the welcome message, the program displays: 


TOMAP Optional Test Sections 
Test Section 2 Identify 
Test Section 3 Self-Test 
Test Section 4 Loopback 


Enter Number for Desired Test Section 
? 


At this point, select the appropriate Test Section by typing 
its number. 


3.3 Messages 


Several kinds of messages may be displayed by IOMAP: 


General messages: Request action from the operator or report 
results of commands. 


Error messages: Response to the operator’s requested 
function was not expected or operator 
entered incorrect information in a command, 


I/O table: ALL responding channels and devices are 
displayed in ascending order according to 
their respective channel address (CHAN ADDR 
switch position) and device addresses 
(DEVICE ADDR switch position). 
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switch position) and device addresses 
(DEVICE ADDR switch position). 


Sample I/O table: 


TOMAP SYSTEM I70 CONFIGURATION i 
Control panel switch settings: Channel=7 Devices4 
System console is device 4 on channel 7 H 
Channel 7 ID=!0 General 1/0 Channel (GIG) © 

Device 3 ID=!i234 XXX Device (CODE =2) H 
Device 4 ID=!43214 YYY Device i 
Channel 4 ID=!4 Async. Data Comm. Channel CADCC) H 
Devices 0-3 ID=!4080 Devices on ADCC MAIN (CODE=4 ,2) i 
Devices 4-7 I[D=!4080 Devices on ADCC EXTEND (CODE=1,2) i 
Explanation of *(CODE=  )*? memes 
i implies: NO L.QOPRACK Capability H 

2 implies: NO SELFTEST Capability H 

i 


End of pass n H 


Note: The devices on the ADCC MAIN and ADCC EXTEND are 
not individually identifiable. The ADCC responds 
to the IDENTIFY command with !4086. 
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4.0 TEST SUMMARY 4 


Std, Seet Deseription Time Notes { 
x 4 1/0 Map S$ sec { 
2 Identify a specific device ms + i 

3 Self-Test a gpecific device ms + { 

4. Loopback to a specific device Ms + i 


Notes: * Part of standard set of sections H 
+ Keeps prompting user for channel and device addresses i 
until °’-2’ is entered. H 


Figure 4.4 - Table of Test Sections ‘ 


442~- 10 APR 44, 1979 


IOMAP ~- TEST DESCRIPTIONS 


‘FO08 O00E Gast ONDE CONG BE DORE GORD DUET feed SHOE ONCE GONE LOdT DORE SDET BEDE SETS GEES WEES bODE snEe OFEE FEES EEDE NNEL SINE S000 TROT HORE OUNE SENT DERE FOND SEER SOR OED CONE SOUE DEFE SORE CONE HOnt GOET SEE SUNT DUET CORE HIND DUDE SONS BUG) SUNT SbNd UNDE SORE DORE GUUS SURE SUNT Stbe Kant SENT eueE GENE SURE SttE DERE bent fend 


5.0 TEST DESCRIPTIONS 


Section 4 ~- I£/0 Table 

The program performs the following sequence for each channel, 
C1) Perform Roll Call on the IMB for specific channel type 
(2) Read Register of the channel 


(3) Perform ID sequence on the channel’s HP~IB, 


Section 2 - Identify 
This test section will display the channel and device ID code and 


type when executed. The following is displayed upon entry of Test 
Section 2: 


Test Section 2-~-IDENTIFY 
Function: To describe the device on a specific Channel 


Enter a channel and device number separated by 
ma comma or, ~2 to EXIT this test section. 


The ALD prompt character °27’, awaits the operator’s response! 


a, Upon entry of a legal channel and device number the test 
executes, 


db. Upon entry of ’~2’ the utility returns the operator to the 
main prompt, 


LTOMAP REVISION XX.XX 


Enter ’GO’? to continue 
7GO , 4’ to continue with Line Printer 


’GO i’? for Optional Test Sections 


7GO 4,4’? to run Optional Test Sections with Line Printer 


(7LCO’ to List Commands) 
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At this time the operator may enter the AID ’EXIT’ command to 
EXIT the IOMAP utility, select another test section, or enter 
*GO’ to continue. 


Section 3 ~- Self-Test H 


In this test section, the following sequence is sent to a 
selected channel/device: 


Initiate Self-Test, read self-test results, and display self-test 
results. Test Section 3 begins with the following title and 
question: 


Test Section 3----SELF TEST H 


Function: To Invoke SELF TEST. H 
Enter a channel and device number separated by a comma or, H 
~2 to EXIT this test section. H 


The AID prompt character, 7?’, awaits the operator’s response. 
Upon entering a legal channel/device number execution of this 
test section begins. (Entering a -2 causes same reaction as 
described in Test Section 2). The Self-Test results are 
displayed upon completion of the test section. The results 
displayed on the first pass sare used as the basis for comparing 
subsequent pass results. On the first pass through this section 
the following message is displayed: 


Tnitial SELF TEST Results = !XXXX 


All supported devices have a good Self-Test result of 0 except 
the 31213 IDS, which responds !4D. 


On subsequent passes the following message is displayed: 
New Self-Test Result Equivalent to Initial Result of !XXXX 
or, 


Self-Test Results changed on Pass X, expected !XXXX Received 
1XXXX, 


NOTE: Not all devices will have Self-Test Capability. 
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Section 4 ~ Loopback 


This test section attempts the HP-IEB loopback function on the 
selected channel/device. This test section begins as follows: 


Test Section 4--~--LQOPBACK 
Function: To perform the LOOPBACK test - 
Enter a channel and device number separated 


by @ Comma or, 
“2 to EXIT this Test section, 


The AID prompt character, °??’, awaits the operator’s response. 
Upon entering a legal channel and device number this test section 
begins execution, (Entering a ~-2 causes the same reaction as 


described in Test Section 2.) Upon completion of this test, the 
following is displayed: 


LOOPBACK test completed 
or 
LOOPBACK ERROR: PASS X BYTE A 
Received !D sent !C 
LOOPBACK Test has completed. 
Note i: Not all devices have loopback capability. 


Note 2: Loopback is not allowed for the device acting 
as system console, 
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6.0 ERROR INTERPRETATION \ 


6.4 20/70 Table Errors { 
{[f ma device responds with an ID code not recognized, the 
following message is displayed in the description field of the 
I/O configuration list. 
"Device responds but ID code undefined". 


Possible cnuses! 


(4) Device is not responding with correct ID code. Look up 
correct code in Section 7.0; check for stuck bits. i 


(2) Device is not supported on system, Check current 
Price/Configuration Guide brochure. i 


(3) Device is newly supported on system and ITOMAP program copy is 
not up-to-date, 


A non-recognized channel type will cause the following message: 
"TD='XXXX xkkUndefined Channel ID code." 
XXXX= ID code of channel. 


Possible causes: 
(1) Operator error 


(2) Channel is identifying incorrectly. Look up correct code in { 
Section 7.03 check for stuck bits. 


(3) Channel is newly supported on system and IQMAP copy is not 
up-to-date, 


6,2 Optional Mode Errors H 


"Device X does not exist on Channel Y. 

Enter an existing channel and device number separated 
by a comma or, 

Enter 7400? to run IOMAP again." 


? 


The AID prompt character, °?’, awaits the operator’s response. 
Each test section will stay in this loop (requesting entry of a 
channel and device number) until a legal channel and device 
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number has been entered. The three Optional Test Sectlons are 
described in detall in Test Descriptions (Section 5.0), 


Possible cnuses! 
(4) Operator Error 


(2) Channel or Device is intermittently failing to identify, 


TOMAP ~ REFERENCE TABLES 
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7.0 REFERENCE TABLES 


7.4 Supported Channels 


IOMAP currently recognizes the following channels: 


GIC (34262) 
ADCC MAIN (341264) 
ADCC MAIN with EXTENDER (34264, 31265) 


Fiqure 7.4 ~ Channel ID Codes Recoanized 


7.2 Supported Devices 


IOMAP currently recognizes the following devices: 


ID code Device 
'0084 7902 Flexible Bisc Unit (FDU) 


19004 7940 Disc Storage Unit (DSU) 
10002 42745 HP-IE Adapter for 13037 Dise Controller 
12004 2608A Line Printer 


t 
12002 2634A Serial Printer H 
12009 26348 Serial Printer H 
'2080 Information Display System (Cor S1i030A Workstation) i 


14080 ADCO Devices 
16000 GIC as device 
18000 PMP T 


Fiqure 7.2 ~ Device ID Codes Recognized 


coy p ome 
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SECTION 446 


HP 360 
SYSTEM I/0 EXERCISER 


EXTERNAL REFERENCE SPECIFICATION 


Product No. 314094 


Program Revision 00.02 and Inter 


References! 
I/O Overview (Handbook Section 762) 
Control Program IMS 
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4.0 INTRODUCTION 


The System [/0 Exerciser is a stand-alone progrom which tests the 
t/O system by generating the £/0 activity of a heavily loaded 
system, it can be used to determine to what extent the hardware 
and Low-level system software are working, 


the program resides on its own cold-Lload flexible disc. 


The program is written in SPL-TT, and uses the low-level system 
software to do I/0. See Figure 41.4 for a description of the 
system software used. The program is self-configquring; i.e., on 
start-up it tries to identify each T/0 device present, and sets 
un default attributes for ench device that it finds. It then 
starts doing I/O to the various devices, If the program runs 
with no errors, you can assume that the software and hardware are 
interacting correctly, and any problems manifested at the 
operating system level probably exist in higher level software, 


The program is most useful for generating random IT/0 tests which 
should catch time-dependent bugs; for intensive testing of 
specific devices or specific areas of dises; and for testing 
yarious I/0 configurations ¢Ce.g. two ADCO Mains vs one ADCC Main 
and one ADCC Extender), 
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PROGRAMS 
(Application programs, compilers, utilities) 


AMTGO/300 H 

(File management, memory management, ; 

program and task mantgement, t 

scheduling) H 
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CONTROL PROGRAM 7 T~-0 H H 

(T/0 drivers, queuing, : H 

synchronization, H H 
interrupts) i 

i ' 

i i] 

St i eae Core ae ee eee ' Services used by H 

i I/O Frerciser 4 

INSTRUCTION SET H H 

i H 

MICROCODE H H 

' i] 

rss Pao i tt y H 

Figure 4.4 - Level of Exerciser in System H 
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2.0 LIMITATIONS 


The System [/0 Exerciser is really a mini-~operating system, and 
therefore requires a minimum set of system modules to be present 
and working. 


C41) You must be able to cold load from ao flexible disc, which 
means the CPU, IMB, GIC, and 7902A must be working to some 
extent. 


(2) The IPS must be working, 


(3) Other devices and channel hardware must be working well 
enough to allow channel programs to execute, 


The program performs only reads and writes to the various 
devices, allowing you no control over the data actually 
transferred, Thus the program cannot be used to check the effect 
of yarious control sequences to the IDS or the printer, 


The program also sets Limitations on the length of the data that 
can be written to the various devices, These Limitations 
currently are; 


i> $280 words to a dise (40 sectors) 

2) 432 bytes to a line printer 

3) 8 bytes to a terminol, the last 2 of which are always 
a4 carriage return/line feed 

4) 255 bytes to an IDS, the first 4 of which are always 
"esck@0" Cwrite data) 


You can specify that you want to write fewer bytes or words to a 
device, but you cannot specify more, Also note that the program 
will always write at least two bytes to a terminal, and at least 
4 bytes to an IDS, : 


The program handles a-maximum of 24 devices. The devices 
currently supported include 


IDS 

77902 disc (single-density, single- and double~ sided) 

794.0 disc 

43037 controller, with any mix of up to 8 7906 and 7920 drives 
2631 printer 

terminals connected vin the ADCC 


The mix of devices that can be handled is limited by memory 
space. There are 38000 bytes of data storage space available to 
the devices; individual space requirements for each device are 


IDS 800 bytes 
disc 3200 bytes 
ADCC main or extender 2400 bytes 
printer 800 bytes 
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Examples to explain this Limitation: i 
A configuration of 416 terminals, 4 IDS, S disc drives, and 2 i 
line printers is supportable by the program, because it totals H 

24 devices using H 


4k2400 + 1kKH00 + Sk3200 + 2k800 = 28000 bytes i 


A configuration of 4 IDS, 9 discs, and i2 terminols is also i 
supportable by the program, because it totals 22 devices using i 


1*800 + 9K3200 + 3*2400 = 36800 bytes H 
But you could not add another disc to this configuration, H 


because even though you would hnve only 23 devices, you would | 
exceed the data space Limitation, 1 
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3.0 OPERATING INSTRUCTIONS 


3.4 Bringing up the Program i 
(You lood it just like a Diagnostic/Utility flexible disc.) 
(4) Insert the flexible disc. Set the Control Panel to indicate H 

the channel and device number of the floppy drive. H 


(2) Press HALT, SYSTEM RESET, and LOAD in that order, The RUN 
light should blink quickly, indicating a soft halt. Now set 
the Control Panel to indicate the chonnel and device numbers 
of the IDS, 


ee ee 


(3) Press RUN, 


Wait about 20 seconds, If nothing appeors on the IDS, check the 
CHANNEL and DEVICE switches, and try repeating from step 1 again. 
The IDS should display a table similar ta that shown in Figure 
S.4. This table contains an entry for ench device that the 
program has identified as being on the system Cidentification is 
done using a channel program which does an Identify to each 
device location). 


wn OM mee 


Device Table 


CHAN/ UNTT DEVICE DELAY DATA SECTOR ADDRRESS CbISct ONLY) i 
DEV # Hf TYPE (MSECS) LEN RANGE TNCREMENT H 
4 § TERM 0 0-80 $S 94600 BAUD / i 

4 i TERM 0 0-80 $ 960 0 BAUD 1 

4 2 TERM 0 0-80 S$ 94600 BAUD { 

4 3 TERM 0 §-80 $ YoO0OBAUD ; 

7 0 () 7706 0 178-1280 R 0-76799 RANDOM READ i 

7 4 7940 0 428-4280 R 0-47039 RANDOM READ H 

Do Se 7702) 0 {28-1280 R 0-4498 RANDOM READ H 

7 4 IDS 0. 0-80 $ H 

Do you want to change any parameters? : 

Figure 3.4 ~~ Example of Device Table and Paorameters H 


Dises attached to the 13037 controller must be powered on and 
ready €i.e@., DRIVE READY Light on) in order to be included in the 
exercise. Discs which come ready after the program has been 
loaded are ignored, 
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3.¢ Interpreting the Device Table 


Each Line in the table describes one device. The hardware 
channel and device numbers that the device is connected to appear 
first, Next, if the device is a disc connected to a 14037 
controller, you will see a unit number, Then you will see the 
device type (e.g., 7902, 7910, 2631). Devices which are attached 
to the system, but that are not supported by the program, are 
ijanored. See Section @, Limitations, for a list of supported 
devices, 


You cannot add to the initial List of devices, nor can you change 
the configuration, once the program is loaded. If you wish to 
add to or otherwise modify the configuration, you must halt the 
system, make your hardware change, and then reload the program. 


The initial device table tells you that you have a double-sided 
(7902D) flexible disc drive on your system Cif the drive is 
connected to the HP-IB). You can use either a single-sided or a 
double-sided flexible disc in the drive; before the exerciser 
beqing accessing the 7902, it checks which type of flexible disc 
is in the drive and accesses the drive according to the flexible 
disc type. It is up to you to ensure that the address field (see 
below) contains the appropriate range. If there is no flexible 
disc in the drive, the program deletes the device from the 
exercise and you must reactivate it as described in steps 4 and 
Sa below, 


In addition to the fields mentioned above, you will see several 
other entries in the table, These entries are labelled across 
the top of the table, and specify various parameters that control 
the I/0. 


The DELAY field is used to specify the time to pause after 
accessing the device. ff this field contains a 0, no pause will 
occur, If there is one number in the DELAY field, then accesses 
will occur at fixed intervals. If there are two numbers, 
separated by a ?—?, then accesses will occur at random intervals 
bracketed by the two numbers. Values are in milliseconds; 
maximum value is 32767, 


The DATA LEN field is used to specify the length of the data to 
be accessed on each I/0 operation, If there is one number in the 
DATA LEN field, then fixed Length buffers will be accessed. If 
there are two numbers, separated by a ’-?, then the data length 
will vary between the two - numbers. For discs, values are in 
words; for oll other devices values are in bytes. Maximum values 
are Listed in section 2, 


For some devices, you will see an ’?S?’ following the second 
number. In this case, the data length will vary 
sequentially between the two numbers, incrementing by one 
until it reaches the high end, and then decrementing by i 
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until it reaches the low end. If an ’7R? appears, then the 
data length will vary randomly, 


For dises, each word of dota in the output buffer is the 
same, with the left byte containing a random ASCII digit, 
and the right byte containing a random letter, For all 
other devices, the data buffer contains the bytes 
7ABCDEFGHIS" preceded by enough blanks to fill out the 
length. 


If the device is a terminal, then the next field in the table 


contains the baud rate at which the terminal will be accessed. If 


the baud rate listed in the table does not agree with the baud 
rate that the corresponding terminal is set to, you will see 
garbage or nothing on the terminal screen, 


If the device is a disc, then there are three more fields: 


The first field contains two numbers, separated by a 77, 
These two numbers specify the low end and high end sector 
addresses to be accessed. Sector addresses are logical 
sector addresses and range from 0 to n, where n is listed 
below for each disc. 


7902 (single-sided) n=2249 
7902 (double-sided) n=4499 


79740 n=47039 
79906 n=7&6799 
7920 n=195599 
These values do not include spare tracks. The program will 


allow you to specify values greater than n for any disc, but 
you Will get an error when the exerciser attempts to access 
a non-existent sector, Note that when you put a different 
flexible dise into the 7902 drive, it is up to you to change 
the address field if necessary. . 


The second field specifies an address increment. If the 
field contains the word RANDOM, then addresses are chosen 
randomly in the range specified. If the increment is 
non-zero, then addresses will increment sequentially by this 
amount up to the high end, and then restart at the low end, 
Maximum yalue is 32767, 


The third field can contain the word “READ’, ’°WRITE’, or 
7R/W?, specifying whether to do input, output, or both to 
the device. If R/W is specified, the device is first 
written to, the same location is read back into a second 
buffer, and the two buffers are compared to see if they are 
equal, If *WRITE’ is specified, you are asked to mount a 
scratch volume; press ENTER when you are ready to continue. 
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WARNING 
Selecting WRITE or R/W will destroy H 


the customer’s data base. READ is 
gaffe to use, 


You moy modify the parameters of the I/0 exercise by changing any 
of these fields, The next steps describe how to do this, 


3.3 Modifying Test Parameters i 
Below the table you wild see the question ’?Do you want to change i 
any parameters?’ followed by the cursor, If you are satisfied i 


With the default parameters, answer ’N’ and press ENTER, Go to 
step 6, If you want to change some of the parameters, or delete 
a device completely, answer ’Y? and press ENTER, 


(4) If you answered ’Y’ to the question, then the phrase ’Enter 
chan/device/unit #:7 will appear on the [DS. Enter the 
channel and device number Cand unit number, if applicable), 
separated by commas, of the device you want to change (from 
the first columns of the table), 


The Line from the table corresponding to the device will be 
rewritten on the IDS. Helow that, you will see the cursor 
positioned in the fifth field. 


(Sa) If you wish to delete the device from the exercise, type 
*X? and press ENTER, Then go back to step 4. This step 
Will also reactivate a device which has been deleted. 


space key or the cursor positioning keys to back up. 
Press ENTER when you are satisfied with your changes. 


(Sl > To modify an J/0 parameter, move the cursor to the i 
desired field (you can use the TAK key), and type the H 
new value(s), If you make a mistake, just use the back H 


The Jine will be rewritten, with the cursor in the last 
column. If the data appears as you desired, then press 
the ENTER key. If you want to make more modifications, 
press any other key, then ENTER, The cursor will 
renppear in the fifth field, so that you can make further 
modifications. When everything looks OK, press ENTER. 


When you finish editing a device’s parameters, the phrase ’Enter 
chan/device/unit #:’ will reappear. If you wish to modify 
another device, then repeat steps 4 and S. If not, or if you 
want to see the entire table again, enter a ’0? (zero). The 
table will be rewritten with your changes incorporated, and the 
question asking for changes will again appear. If you want to 
make more changes, answer ’Y’? and go back to step 4. If not, 


we me 


APR 410, 1979 446- ii 


SYSTEM I/70 EXERCISER ~ OPERATING INSTRUCTIONS 


POO HOR Heed SOOT FOES COED BEET SESE COR BERT F000 BEES HOE EOEE BOO CON SEED EOTE FOOT DERE COND EEE SERS SOUS ORES FOES BOOT COOL CDE OEE TEES ELED SUED FOOL EHUD SHOE FOUR FEE SENS HESS HOES CORD HODE HOES OEE HOES FEED SHEE HEED Cone FEES BEES FORD CEOS EEEE SEER EEEO FUDD BODE SEER ROVE PEED sobs CEES OOD COOL EDEL SEED sHEe coEt 


answer 7N?, 


(6) When you answer ’N’ to the question, the program will ask 
you some questions concerning program control. If there is 
aoprinter on the system, you will be asked ’Do you want 
output on the printer?’ If you answer ’Y’, then the device 


table will be written out, on the printer, and error messages 
and data concerning accesses will also be echoed there. This 


output does not affect the performance of the I70 exerciser. 
If there are two printers on the system, the printer with 
the highest channel/device number is the one written to. 

The default answer to the question is ’Y?, 


The last question asked is ’Do you want to stop on an 
error?’?. If you answer ’Y? to this question, the program 
will pause after reporting an error, If you answer 7N?, 


then, when an error occurs, the error will be reported, data 


concerning accesses will be dumped to the IDS and printer, 
and the program will restart. This mode is useful for 
overnight operation. You can set up the program, specify 
output to the printer, answer ’N’ to this question, and 
leave. When you come back you will have a record of any 
errors that occurred. The default answer is ’7Y?’., 


3.4 Program Operation 


After the last question, the program begins doing the specified 
I/O operations to the devices. You will see output on the TDS, 


and hear the discs being accessed, You can interrupt the program 


at this time by hitting the ATTN key (Step 7, below), 


As the program is doing the I/0, it logs information about its 
accesses. For each device, it logs the length of the data buffer 
written, the address written to, and the wall-clock time it took 
to do the access. This information is stored in a circular 
buffer with room for 10 entries. 


3.5 Interrupting the Program 


(7) When you hit ATTN, the question ’?Do you want to see the 
access data for any device??? will appear on the TDS. Tf you 
reply ’Y?’ to this question, then you will be prompted for a 
channel and device number, Enter the numbers for the device 
you desire information about, The information will then be 
written out, and you will be reprompted. Enter another 
device number, or. 70? (zero) when you are ready to go on, 


(8) The question “Continue or Restart?’ will now appear on the 
IDS. If you want to continue from the present state of the 
exerciser, answer ’C? and go to step (6). If you want to 
modify some more parameters, or simply restart with the same 
parameters, answer ’R’? and go to step ¢4), 
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Note: Jf a dise goes offline, and then comes back online 
(e.q., if you take out the flexible disc and insert a new 
one), you must answer ’R? Crestart) to this question, 
Otherwise, you will get back an error code of $3800 each time 
the exerciser tries to access that disc, Restarting the 
exerciser will clear this error, 
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The 


arr 


ERROR INTERPRETATION 


reoare two kinds of errors reported by the program: [70 
org and Exerciser program errors, 


{/0 errors are reported directly on the IDS Cand on the printer, 


if 


ay 


®, 


f, 


Qj 


After an error is reported, the program continues ag described in 


it is configured), Information reported includes: 


the channel 
error 


and device number of the device that reported the 


the error code (see Section S for an explonation of error 
codes) 


if the 70 access was a read or write, the program wild 
display the length of the data buffer, and, if requested, its 
contents, The data is displayed both in hex and ASCIT. If 
the device is a disc, the sector address that was accessed 
Will agliso be reported, 


the other parameters to the I[/0 request which include athe 
request code CREQ’CODE; (READ, @=WRITE, S#WRITE? READ, other 
values depend on the device); the request priority CPRIORITY; 
should always be £00); and two control parameters CCONTROLA 
and CONTROL2@; these are device dependent) 


the transmission log, which is the number of words or bytes 
actually transferred on a read or write 


the TCR# of the task controlling the device, and ECB# of the 
I/Q request, which may be useful for debugging. 


the phrase ’END OF MESSAGE? 


step 7 above, 


Ex @ 


C4) 


reiser program errors are reported in three ways: 


Crash message, Ignore the parameters and reload the 


program. If it crashes again, there is something drastically 


wrong. Check your configurations if nothing is amiss, call 
your System Specialist. 


RUN Light blinks (heartbeat). Check the NIR Lights Con BUS 
INTFC board) for an error code, Current errors: 
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SYSTEM [7/0 EXERCISER ~ ERROR TNTERPRETATION 


4 =~ couldn’t initialize GIC 


You can try to continue by pressing RUN, but you probably 
won?t get very far, Try reloading the program and checking 
your configuration. If that doesn’t help, call your System 
Specialist, 


Call to system debug (SYSDEBUG). You can try to continue by 
typing "EX" and pressing the ENTER key. The program wild 
prohabiy do funny things though. Try reloading the program 
and checking your configuration. 
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5.0 FRROR CODES 


The error code reperted by the program is the one returned by the. 


physical device driver, and is dependent upon device type, 


To get further information about any errors, you will have to 
look at the software Listings or examine the HP-I8 transactions, 


544 DS Error Codes 


10044 - channel program error 
10024 - channel input overrun 
10084 - self-test error 


my ra 


5,2 Dise Error Codes 


10404 - illegal opcode 

'o204 — invalid parameter 

(0204 ~ unit available 

10704 —- cylinder compare error 
(G04 ~ uncorrectable data error 
10904 ~ head/sector compare error 
'0A04 - [70 program error 

10004 —- end of cylinder 

(QE0S - data overrun 

1O0F04 ~- possibly correctable error 
14004 ~ illegal space track 
14404 ~ defective track 

(4204 ~- head motion detected 
14304 ~- status 2 error 

14604 ~- protected track 

14704 - unit unnyvailable 

{Fr 04 ~ drive attention 

12006 ~ busy (794 0=0f Ftrack) 
12400 - offline 

12407 ~- powerfail 

2200 ~ online 

12300 ~- power of f 

[2406 - drive fault 

12506 ~ HP-IR error 

(2606 ~ device was cleared 

12704 ~ FIFO abort 

1206 - serial poll error 

12904 ~ illegal CSR 

12A04 ~ protect switch an 

I2R02 - timeout ~- IME 

2002 ~- timeout ~ HP-TB 

12D06 ~ data chain error 

I2E06 ~- bad channel instruction 
l2F OG ~ SIOP failure 

13006 ~ address rollover (Cnon-DMA) 
13406 ~ HP-LB parity error 

1Se02 - watchdog timer 


446~- 16 APR 10, 4979 


wm we 


me 


—= 


a ee Le. ee. tt) te To) 


ca me ee ee ee ee ee 


SYSTEM [70 EXERCISER - ERROR CODES 


eeee cece vasa Cone CONe Bees Sous Cees COne CECE Rene DEEL SEED SEE CEES SEES RODD EODT HEE ORES snes SEEH SOOT SOnD EEEE SEED EES HOES ENED GORS GOEL DEES EEE BEEF SEL COED GERE EET OEEE BEDE SORE Cone F50S EbET SESE BOER DRED Sore BEEe SEES Sos ores Cane CUES SOLE 4408 CHEE OOEE FEE DEED OES BEES EOEE DEES BEE COEE attH CODD athe Habe 


13404 —- seek check H 
13704 - DST error H 
13800 —- blocked driver H 


13906 ~— DMA address rollover ' 
13A06 - PMA non-reponding memory module H 
5.3 Terminol Error Codes CADCC) i 


(9007 ~ driver bugy 


1000K - request not cancelled : 
10403 ~- invalid porameter 1 
Ixx09 - request cancelled H 
Ixxfi - parity error H 
Ixx24 - overrun error } 
'xx44io- channel program abort H 
8x0i ~ TX Line bad -- disconnected i 
Oxf - TX Line bad -- disconnected H 
x ~ don’t care H 
5.4 Printer Error Codes H 
'900K — yolume monitor online status H 
(9204 ~ illeqal parameter H 
'0804 ~- paper out H 
10904 ~— offline H 
(NA04 - not rendy H 
10B04 ~— HP-TR command parity error i 
'0C00 - power on Creset) H 
14402 - watchdog timer ' 
14204 ~ STOP failure i 
12506 - HP-IB error i 
12606 ~- device was cleared i 


12704 ~ FIFO abort 

PROG - serial poll error 

12904 —- illegal CSRQ 

(PA0NA - protect switch on 

PRO - timeout ~ IMG 

12C02 ~- timeout ~- HP-IB 

12D06 ~ data chain error 

IPEOG - bad channel instruction 
I2F06 ~- non-respoending device 
(3006 - address rollover Cnon-DMA) 
13406 ~ HP-IER parity 

13906 ~ DMA address rollover 

13A06 ~ DMA non-responding memory module 
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The information contained in this document is subject to 
change without notice, 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERTAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE, Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse- 
quential damages in connection with the furnishing, per- 
formance or use of this material, 
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Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard, 
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This document contains proprietary information which is 
protected by copyright. All rights are reserved. No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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NOTICE 


The information contained in this document is subject to 
change without notice, 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE, Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse-~ 
quential damages in connection with the furnishing, per- 
formance or use of this material, 


Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard, 
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This document contains proprietary information which is 
protected by copyright. All rights are reserved, No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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4.0 INTRODUCTION 


4.4 Product Abstract 


This document details the external reference specifications for 
FMDISCUT, one of the File Management standalone utilities on the 
HP 300 system. 


1.2 Overview 


File Management provides the user several basic utilities which, 
because of the functions they perform, must be executed in the 
stand alene environment. These utilities are presented to the 
user as options within the FMUTILIT (File Management Utilities), 
FMDISCUT (File Management Volume Utilites), and FMPATCHY (File 
Management Patch Volume>d programs which are provided to the user 
on the cold londnble Diagnostic and Utility Package (DUP) 
flexible discs. The intended uses of ench program are listed 
below: , 


UTILITY USES. 


FMDISCUT: detect and spare bad tracks 
indicate the condition of a surface 
prepare a surface for use 
[covered in this Handbook Section] 


FMUTILIT: copy non-standard volumes and cartridges 
back up systems 
Store or Restore information 
replace the primary with the back-up operating system 
[covered in Handbook Section 4470] 


FMPATCHYV: inspect or modify the the contents of a volume 
(DUPCE output the contents of a volume in hex, octal or decimal 
only) [covered in Handbook Section 447D] 


The details of how to load a DUP flexible disc and the 
environment it initially provides the user are described in the 
DUS handbook section (440). This document describes only the 
FMDISCUT programs, 


4,3 Required Hardware 
The HP 300 configuration sufficient to run DUS is required, This 


includes 256 Kbytes of memory, a GIC, CPU, 7902 and an IDS or 
ADCO with a terminal as a console, 
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4.4 Required Software 


The Diagnostic and Utility Package containing FMDISCUT (DUP or 
DUPCE), 
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2.0 OPERATION 

Once the DUP flexible disc has been successfully cold loaded and 
the prompt character "i" is present the user must enter 


7FMDISCUT’? to enter the File Management Volume Utilities program. 


The FMDISCUT program is made up of all of the subprograms listed 
in the menu below, The program initially outputs: 


Welcome to the Volume Utility Program Revision xx.xx 


Please select one of the following options: 


Analyze Volume AV 
K Assign Spares AS 
Exit EX 
K Format Volume FY 
List Track Status LS 
Kk Prepare Volume PY 


KPlease consult with your SE before using these functions 
Enter option: 


The user must now enter the two-character code of the desired 
option. A response of ‘EX’ terminates the program and returns to 
the environment that was initially cold loaded, If a code is 
entered that is not in the menu list then the message: 


Tllegal option selected 


is output and the user is reprompted for the option, Once a legal 
option, other than ‘EX’, has been entered the function is 
invoked, Upon completion, successful or unsuccessful, of the 
function the previously detailed menu is output again and the 
user is prompted to enter the next option, 


Any I/O errors that are encountered during the execution of a 
function are communicated to the user through the, messages 
detailed in Section 3.0, 


2.4 Analyze Volume 


This function is invoked whenever the “AV? function is selected. 
Analyze Volume reads the data field of each sector in each track 
using the read verify command, Read verify computes the CRC word 
and compares it with the existing CRO word to determine if there 
were any data errors, Tighter timing constraints and the fact 
that READ VERIFY does not transmit data to memory distinguishes 
READ VERIFY from READ. If a defective track is found its location 
Will be output on the selected peripheral (i.e., the IDS, a 
terminal used as a console, or Line Printer), If track number 
zero, head number zero is found to be defective then the volume 
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igs defective and must not be used. 
The function initially outputs the messaqe: 
ANALYZE VOLUME function now in operation 
followed by: 
Enter volume’s channel number: 
Valid Response: 
Expecting 4 to 45 
Inquiry: 
Enter volume’s device number: 
Valid Response: 
Expecting 0 to 7 
Inquiry: 
Enter yvolume’s unit number: 
Valid Response: 
Expecting 0 to 7 
Once a valid channel, device, and unit have been specified the 
following interaction occurs if the volume to be analyzed must be 
nounted on a 7902, 
Inquiry: 
Will you please mount the volume? 
Valid Response: 
Expecting YES or NO 
A response of ‘NO’ terminates the function. A response of ‘YES?’ 
should be entered only after the volume has been mounted. If the 
volume is a flexible dise and it is not properly formatted the 
Message | 
Flexible Disc needs to be RE-FORMATTED 


is output and the menu i6 again presented, Regardless of the 
median to be analyzed the system will then output the message: 
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The option you have selected will READ/VERTFY all data on the 
chosen <dev named <vol type> volume, 


<dey name> will be °7902’, ?7940’, 7906? ete} 
{vol type> will be one of the following volume types: 


STANDARD 
NON-STANDARD 
SYSSTORE 

BACK ~UP 

DUS 

INTERCHANGE FORMAT 


The following menu is then output: 


Clear print echo CPE 
Execute option EXC 
Exit EXI 
Set printer eche SPE 
Show commands SHW 


followed by: 
Enter command: 
If an illegal command is entered the message: 
Illeqal command entered 


is output followed by a prompt for another command. The EXT 
command exits the function and results in the user being prompted 
for another FMDISCUT function. The EXC command results in the 
function being executed, After it completes the user is prompted 
for another FMDISCUT function. The SHW command outputs the above 
menu. The CPE, and SPE commands result in the output of the above 
menu upon their completion. 


If the channel, device, and unit numbers specify a 7906 then the 
user is given the option of analyzing the upper platter, the 
lower platter, or both platters through the addition of the 
following command to the menu: 


Select platter (s) to analyze SPA. CUPPER/LOWER/ALL 3 
If EXC is selected before SPA when analyzing a 7906 the message: 
Platter(s) must be selected with SPA command 
is output and the user is prompted for another command. "UPPER" 
specifies that only the upper platter is to be analyzed, "LOWER" 
specifies that only the lower platter is to be analyzed, and 


"ALL" specifies that all platters are to be analyzed, If illegal 
values are entered for SPA then the message: 
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Illegal value(s) entered 
is output and the user is prompted for another command, 
SPE enables echoing of any output, resulting from the execution 
of the function, to a printer and CPE disables the echoing of any 
output. Echoing is initially disabled, The SPE command interacts 
With the user to obtain the channel and device number of the 
printer as follows: 
Inquiry: 
Enter printer channel number: 
Valid Response: 
Expecting i to 415 
Inquiry: 
Enter printer’s device number: 
Yalid Response: 
Expecting 0 to 7 


Lf the device does mot identify itself os a 24314 or a 2608A the 
ARSSage t 


Device is not a printer, 

ig output. 
Once the channel and device mumber of a printer has been input 
printer echoing is enabled. When the EXC command is entered the 
volume is analyzed. 
For each defective track which has not had an alternate track 
assigned to it a specific I/O error messnge (detailed in Section 
3.0) will be output along with the message: 

Defective track ttt, head h 
where ’ttt? and “*h? are the track and head numbers involved. If 
the volume is found to be defective (Ci.e., 0/0/70 has been found 
to be bad in some way or there are more defective tracks than 
spare tracks available} the message: 

The volume on channel ’c’, device ?’d’?, unit *7u’? is defective, 


is cgutput, Upon completion the messaqe: 


ANALYZE VOLUME completed successfully 
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ig output and the FMDISCUT menu is presented, 


2.2 Assign Spares 


This function is invoked whenever the option ’AS’ is selected and 
results in the assignment of an alternate track Cif one exists) 
to the specified defective track. A track located in the spare 
area can algo be spared, however, neither the defective nor the 
spare track will be usable by the system. (flexible dige 
defective tracks are handled differently and will be addressed 
geparately in a later paragraph). 

Tf a 7906, 7920, op 7925 disc drive indicates to the disc driver 
(goftware internally used by the File Management Utilites) that a 
possibly correctable data error has been read, then the digse 
driver will attempt to correct the error, If it is successful, 
the data will be written to the spare track without any error 
indication being made to the Assign Spares function, TF the error 
cannet be corrected a READ FULL SECTOR command is issued by AS. 
This will effectively bypass the error checking mechanism of the 
digc and write the data out to the spare track. Since the error 
did occur, this data may be corrupt so use it with eautionil! LF 
the READ FULL SECTOR cannot complete successfully, the track will 
be spared but the data will not be written out to the spare 
track, 


If the data cannot be read from the track to be spared without an 
error, the volume’s label Cif it is labelled) will be altered, 
This will prevent the volume from being mistakenly used as 
initially intended Cexample: as a good, cold Londable labelled 
yolume)d, 


The function initially outputs the message: 

ASSIGN SPARE TRACK function now in operation 
and then interacts with the user in the identical manner detailed 
in Analyze Volume (Paragraph 2.43 to obtain the channel, device, 
and unit number of the volume, and get the volume mounted, If 
the volume is a flexible disc and it i6 mot properly formatted 
the messade: 

Flexible Digse needs to be RE-FORMATTED 
is output and the menu is again presented. Once the system 
recognizes the device and type of volume which is to be spared 
the following message is output: 


Track(s) will be marked defective on the chosen 
{dev name> <volume type> volume, 


Do you wish to continue? 
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If NO is answered the FMDISCUT menu is presented, otherwise the 
function continues by listing the menu for AS. 


The menu for Assign Spares will contain the following command in 
addition to those already discussed in Analyze Volume, 


Enter DEFECTIVE track address DTA <(Cyl no.>,<Head no,> 


When the DTA command is selected the user is specifying with «Cyl. 
no.) and <Henad no.> the track which is to be marked defective. 


When the EXC command is entered and a volume attached to a 413037 
is having a track spared the message: 


Set protect switch OFF and format switch ON 
is output and then the following interaction occurs: 
Inquiry: 
Is disc drive ready? 
Valid Response: 
Expecting YES or NO 


A response of ’NO’ terminates the function, A response of “YES? 
should be made only after the protect and format switches have 
been set as requested, Once the track to be spared has been 
identified and the EXC command has been entered the track is 
read, If no errors occur during the read the data will then be 
written out to the spare track, If errors do occur the process 
described above will be initiated. Whenever the dise driver has 
been notified that an error has occurred the message: 


Datn lost from sector ss, track ttt 
Will be output, 


If the volume was a standard volume (ie, a volume whose label was 
created by the CREATE LABEL command) or an Amigo “labelled 
volume" (such as a SYSSTORE volume created by the STORE VOLUME 
command) data recovery will be attempted in the same way as the 
unlabelled volume above. However, if a read error does occur the 
label will be marked to indicate a bad volume. Along with the 
above message the following message will be output: 


Since data was lost on the chosen (dev name>) (volume type> 
Volume please consult with your SE before an attempt is 
made to use this volume, 


If the volume is a 7906 with a nonmatching label and an error 
occurs during the data rend the message: 
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Volume label mismatch. babel is ¢volume name> 


Do. you want the cartridage/platter to be used as a NON-STANDARD 
volume? 


Will be output where <volume name> is the label Cor ... if no 
label exists) on the upper or lower platter, If YES is answered 
the track will be spared, the data will be Lost and the upper 
Label will be modified if the track getting spored is on surface 
0 of 4, or the lower label will be modified if surface 2 or 3 has 
the track to be spared. If NO is answered the track will not be 
spared, Instead the FMDISCUT menu will be presented, 


When AS is used with flexible discs, tracks are not assianed 
alternates, Instead, they aré made invisible so that they can’t 
be written to. No data recovery at all is attempted when 
flexible disc tracks are spared. Also instead of the track being 
spared after the DTA and EXC commands are invoked, the sparing 
doesn’t occur until after the EXI command is entered, Only when 
EXI is used with flexible disc does it also cause the entire 
Hedia to be formatted (thus destroying all existing data}! This 
reformatting is necessary because of the way AS changes the 
logical/physical track relationship on a flexible disc. (See 
Service Handbook Section 860 for more details.) 


WARNING: the address of all bad tracks to bé spared must be 
input on the same pass of AS (Ci.e., before EXT is 
entered). 


If illegal values are entered for (cyl mo.) or (head no.) the 
MESSAge : 


Tllegal value(s) entered 


is output and the user is prompted for another command. If EXC is 


selected before DTACi.e., before a defective track is defined? 
the messaqe: 


Defective track must be selected with DTA command 


is output and the user is prompted for another command. The 
messaqde } 


Defective track ttt, head h, assiqned alternate track ttt, 
head h 


is output for each defective track that is assigned an alternate 
(no message is output for a flexible disc). 


The input of a cylinder and head number of zero will result in 
the output of the message: 


A defective track on cylinder 0, head 0 cannot be assiqned a 
spare 
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The volume on channel ’c’, device ’d’, unit ?u’? is defective 

For media mounted on a 43037 type drive the message: 
Turn format switch OFF, Disc ready? (YES/NO) 

is cutput. The message: 
The specified track is already marked defective 


is output if the specified track already has an alternate 
assiqned to it. The message: 


An assiaqnable spare track was not found 


is output when no Spare track can be found to assign as an 
alternate, Upon completion the message: 


ASSIGN SPARES successfully completed 


is output, 


2.5 Exit 


The selection of the ’EX? option results in the FMDISCUT program 
being terminated and control returned to BUS. 


2.4 Format Volume 


This function is invoked whenever the option ‘FV’? is selected. 

It results in the initialization of the preamble of and the data 
field in every sector of the volume Cor specific surface) which 
is being formatted. When a volume is formatted the physical 
address of each sector within each track being formatted is 
rewritten in that sectors preamble. Also the SPD bits which are 
the bits in the preamble that indicate, when set to one, that the 
track is a Spare(S), protected(P) or defective(DI) are set to 
zero thus requirina all tracks previously spared to he spared 
again after the formatting has completed. 


Note: this function iqnores data errors and thus will not report H 
any bad tracks encountered, If a surface needs analyzing i 
use Prepare or Analyze Volume functions. H 
e 
' 
The function initially outputs the message: 


FORMAT VOLUME function now in operation 


and then interact with the user in the identical manner detailed 
in Analyze Volume (Paragraph 2.4) to obtain the channel, device 
and unit number of the volume, get the volume mounted, warn of 
the destruction of data on the volume and to get the protect and 
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format gwuitches set Conly when 13037 drives have been 
ddentified)d, 


If the channel, device, and unit numbers specify a 7906 then the 
user Ls given the option of formatting the upper platter, the 
lower platter, or both platters through the addition of the 
following command to the menu described in Section 2.4: 


Select platter(s) to format SPF CUPPER /LOWER/ALL3 
If EXC is selected before SPF when formatting a 7906 the message: 
Platter(s) must be selected with the SPF command 


is output and the user is prompted for another command, "UPPER" 
specifies that only the upper platter is to be formatted, "LOWER" 
specifies that only the lower platter is to be formatted, and 
"ALL" specifies that all platters are to be formatted, 

Currently, however, an error message will be output if either the 
upper or lower protect switches are set, regardless of the 
platter selected. Therefore make sure that both protect switches 
are off. If illegal valves are entered for SPF the message: 


Tllegal value(s) entered 


is output and the user is prompted for another command. When the 
EXC command is entered the volume is formatted. 


If the volume being formatted is a flexible disc that is 
unformatted or there are less than 74 usable cylinders the 
function will output the message: 


The UNFORMATTED volume on device <dev name> will be FORMATTED. 


after EXC has been entered. The above message will also be output 
Lf the label in sector zero cannot be rend. 

Upon completion of the formatting 

the message: 


FORMAT VOLUME successfully completed 


is output. 


2.95 List Track Status 


This function is invoked whenever the option ’LS’ is selected, LS 
determines the status of all tracks on a volume by reading the 
preamble of each sector within the track, It then scutputs the 
status of ench track if the track if in an abnormal state (such 
as spared or defective in some way). The function initially 
outputs the message: 
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LtoT TRACK STATUS Ffunctlon now in operation 


and then interacts with the user in the identical manner detailed 
in Analyze Volume (Paragraph 2.4) to obtain the channel, device 
and unit number of the volume and get the volume mounted. If the 
channel, device, and unit numbers specify a 7906 then the user is 
given the option of listing the track status of the vpper 
platter, the lower platter, or both platters through the addition 
of the following command to the menu described in Section 2.4: 


List trk status of platter(¢s) LSP CUPPER/LOWER/ALL3 


If EXC is selected before LSP when listing track status on a 7906 
the message: 


Platter(s) must be selected with the LSP command 
is output and the user is prompted for another command, "UPPER" 
specifies that only the track status of the upper platter is to 
be listed, "LOWER" specifies that only the track status of the 
lower platter is to be listed, and "ALL" specifies that the track 
status of all platters is to be listed. If illegal valves are 
entered for LSP then the message: 

Tlleqal value(s) entered 
is output and the user prompted for another command. The 
selection of the EXC command results in the outputting of one or 
more messages which describe the status of the volumes tracks. 
If the volume is a flexible disc and it i8 not properly formatted 
the message: 

Flexible Disc needs to be RE-FORMATTED 
is output and the menu is again presented, 
If the volume is a flexible disc then the message: 


The volume on channel ’c’, device ’d’?, unit ’u’ does not have 
any defective tracks 


is output if no tracks are flagged defective. 
If defective tracks are found then the message: 


The volume on channel ’c’, device *d’, unit ?u’? has ?n? 
defective tracks 


(where n iss the number of defective tracks) is output, 
If the volume is not a flexible disc then the message: 


Defective track ’ttt’, head ’h’, assigned alternate track 
ttt’, head 7h? 
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is output for each defective track found that has been assianed 
an alternate track and the MESSAGE : 


Defective track ?ttt’?, head 7h’, no alternate track assigned 


is output for each defective track found that has not been 
assigned an alternate. The HP 300 system requires all defective 
tracks to be assiqned spares or for flexible disc made invisible. 
AS can be executed to perform those tasks. The message: 


List track status completed successfully 


is output upon successful completion. te 


2,6 Prepare Volume 


This function is invoked whenever the option *P¥V’ is selected. It 
prepares a volume in one step by automatically calling List Track 
Status, Format Volume and a volume verification function which 
spares any track it determines to be defective (axcapt c/h/s 
6/0/70). It will also spare those tracks which were listed as 
defective by the List Track Status pass. The function initially 
outputs the message: . 


PREPARE VOLUME function now in operation 


and then interacts with the user in the identical manner detailed 
in Analyze Volume (Paragraph 2.4) to obtain the channel, device 
and unit number of the volume, get the volume mounted, warn that 
ali data on the volume will be lost and to get the protect and 
format switches set Conly when a 13037 drive has been 
identified). 


If the channel, device, and unit numbers specify a 7906, then the 
user is given the option of preparing the upper platter, the 
lower platter, or both platters through the addition of the 
following command to the menu described in Section 2.4: 


Select platter (s) to prepare SPP CUPPER/LOWER/ALL) 


If EXC is selected before SPP when preparing a volume on a 7906, 
the message: 


Platter<s) must be selected with the SPP command 


is output and the user is prompted for another command. "UPPER" 
specifies that only the upper platter is to be prepared, "LOWER" 
specifies that only the lower platter is to be prepared, and 
"ALL" specifies that both platters are to be prepared. 

Currently, however, an error message will be output if either the 
upper or lower protect switches are set, regardless of the 
platter selected. Therefore make sure that both protect switches 
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are off, If illegal valves are entered for SPP, the message: 

Illegal value(s) entered 
is output and the user is prompted for another command. The 
selection of the EXC command results in the outputting of the 
message! 

List Track Status pass started 
and the outputting of one or more messages that describe the 
status of the volume’s tracks as discussed under the section List 
Track Status. If the volume being prepared is found to have 
defective or defective and spared tracks, one of the two 
following additional messages will be output. When preparing a 
flexible disc, the message: 


The above track(s) will be kept invisible 


is output. When preparing volumes other than a flexible disc, 
the message: 


The above track(s) will be marked defective and spared 


is output after the message indicating the defective track 
address. 


If a bad preamble is encountered the above message will be 
followed by the messaqes; 


EXCEPT TRACK(s) with bad pre-ambles. 
Preambles are RE-WRITTEN during the FORMAT pass 


Upon completion of List Track Status, Format Volume is invoked 
and the messaqe: 


Format pass started 
is output. If the volume has an improper HP format the message: 
All DEFECTIVE tracks, if any, were lost 


is output. DEFECTIVE will be replaced by INVISIBLE in the above 
message if the volume is a flexible disc. 


If the volume being prepared is a flexible disc that is 
unformatted or there are less than 74 usable cylinders the 
function will output the messaqe: 

The UNFORMATTED volume on device (dev name> will be PREPARED, 


The above message will also be output if the label in sector 
zero cannot be read, After Format Volume completes successfully, 
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the message! 
Volume verification pass started 


Ls output, At this time a non-exhaustive analysis of the data 
fields of each sector on the disc volume is done, A Spare track 
is nssiqned to each track it determines to be defective. If the 
volume is a flexible disc, three read~verify passes are 
performed. Following this, the message: 


The bad track(s) found previously will now be marked defective 
and spared 


is output and all defective tracks as well as those listed during 
the LS phase are marked defective and spared (bad tracks on 
flexible disc are made "“invisible"). Upon completion of the 
volume verification, the message: —— 


If additional tracks are to be marked defective, please use the 
AS option 


is output to inform the user to use Assiqn Spares to spare 
additional tracks not found by PY that are suspected to be bad, 


At this point, Prepare Volume has successfully completed and the 
message: 


Prepare Volume completed successfully 


is output. 


In the Copy Volume function only a retry after a write/verify is 
attempted. If an error is encountered during the first 
write/verify pass the function will output the location of the 
problem and automatically retry. A verify failure during the 
second write/verify pass will stop CV before it completes. 


Figure 2.4 ~ Restore Volume Drive Combinations 
A date and time should be included in the ID label because if the 
label typed in is identical to the previous store volume label 
the disc would be rejected. This will prevent the current store 
operation from accidently overwriting a valid store disc. 
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$10 ERROR INTERPRETATION 


Tf any 1/0 errors are encountered during the execution of any of 
the File Management Utility or Patch Volume functions the user 
Will be informed of the error through one of the messages 
detailed in this section. 


The error messages are divided into correctable errors and 
uncorrectable errors, For a correctable error the user will be 
informed of the problem and asked to respond “YES? to a prompt 
when the condition has been corrected. If the user responds ’NO? 
then the function is terminated and the user is prompted to 
select another function. 


For an uncorrectable error the user is informed of the problem 
and the function is automatically terminated and the user is 
prompted to select another function. The messages are as 
follows: 


Correctable Errors 


Device on chan/dev/unit is not ready 
Device on chan/dev/unit is write protected 
Flexible disc mounted is not in HP format 
Turn format switch on - chan/dev/unit 


Uncorrectable Errors 


Drive attention on chan/dev/unit 
L[/O foiled after ’n’? retries 
Device is not a disc 

Device is not a printer 

Channel type is not GIC 

Channel is not present 

[I/O error on chan/dev/unit 
Watchdog timer or parameter error 


followed by: 
Cannot report status 
Cylinder *’c’?, head *h’, sector *s? 


Relative sector number ‘@r? 


and then: 


Channel status Statusi Status2 
(channel (status (status 
status) 4 word> 2 word) 


"chan/deyv/unit” will be the decimal numbers for the channel, 


device, and unit, ?’n’ will be the decimal number of retries, 
707, 7h?, 78%, and ’r? are, respectively, the decimal numbers for 
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the cylinder, head, sector, and relative sector addressed. All 
COPY, STORE, and RESTORE volume commands read/verify every data 
transfer, 
Whenever the system encounters a Disc I/0 error the appropriate 
Message listed above will be Followed by a message of the 
Following form: 
Dise I/O error xxx~~ Ctext message> on device <dev name> 
»Channel ’c?’?, device ’d’?, unit ’u’? at relative sector z 
(cylinder ’c?, head 7h’, unit 707), 
The error number xxx and <text message> which would be used are 
the same as those output by Amigo/300,. The error numbers and 
Messages are listed in Handbook Section 199 -- Error and Status 
Codes. 
The messaqe: 
Verification of data written has failed. 
is output by the system if a read verify of the lower platter of 
a 7906 has failed (a read verify is done after every write) . If 
the read verify fails after a write toa removable cartridge the 
above message will be followed by the message: 
Error detected on upper platter. Please remove, 


The function will continue after the cartridge has been replaced, 


If an error occurs and the printer echo is not enabled, the 
MeSsaqe: 


Is the above message recorded? 
ig output, The user may wish to record the message and then type 
7¥? or ?N? CPYES? or °NO?), If the above is not typed, the 
MESSage ! 

Expecting YES or NO 


is output, 


Following the output of any of the correctable errors the user 
WLIL be prompted with: 


Inquiry: 
Drive ready? 
Valid Response: 


Expecting YES or NO 
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The user should respond ’YES’? only after correcting the problem. 
A response of ?NO?’? results in the function being terminated and 
the user prompted to select another File Management Utility or 
Patch Volume function, 


fy pe 
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NOTICE 


The information contained in this document is subject to 
change without notice. 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE. Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse- 
quential damages in connection with the furnishing, per- 
formance or use of this material, 


Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard. 


This document contains proprietary information which is 
protected by copyright. All rights are reserved, No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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4.0 INTRODUCTION 


4.4 Product Abstract 


This document details the external reference specifications for 
FMUTILIT, one of the File Management standalone utilities on the 
HP 300 system, 


4.2 Overview 


File Management provides the user several basic utilities which, 
because of the functions they perform, must be executed in the 
stand alone environment. These utilities are presented to the 
user ag options within the FMUTILIT (File Management Utilities), 
FMDISCUT (File Management Volume Utilites), and FMPATCHY (File 
Management Pateh Volume) prograns which are provided to the uger 
on the cold loadable Diagnostic and Utility Package (DUP) 
flexible dises, The intended uses of ench program are listed 
below: 


UTILITY USES 


FMDISCUT: detect and spare bad tracks 
indicate the condition of a surface 
prepare a surface for use 
[covered in Handbook Section 4478] 


FMUTILIT: copy non-standard volumes and cartridges 
back up systems 
Store or Restore information 
replace the primary with the back-up operating system 
[covered in this Handbook Section] 


FMPATCHY: inspect om modify the the contents of a volume 


CDUPCE output the contents of a volume in hex, octal or decimal 
only) {covered in Handbook Section 447D1 


The details of how to load a DUP flexible disc and the 
environment it initially provides the user are described in the 
DUS handbook section (440), This document describes only the 
FMUTILIT program, 


4.3 Required Hardware 
The HP 300 configuration sufficient to run DUS is required. This 


includes 256 Kbytes of memory, a GIC, CPU, 7902 and an IDS or 
ADCO with a terminal as a console, 
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4£,4 Required Software 


The Diagnostic and Utility Packnge containing FMUTILIT CDUP or 
DUPCE)., 
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2.0 QPERATION 


Qnee the DUP flexible disc has been successfully cold Londed and 
the prompt character "i" is present the user must enter FMUTELIT 
to enter the File Management Utilities program, 


The FMUTILIT pregqram provides those functions Listed in the menu 
below, 


Welcome to the File Utility Program Revision xx.xx 
Please select one of the following options: 


K Copy 7906 Cartridge CC 
Clear printer echo CE 
Copy volume CY 
Enable back-up system ER 
EX it Ex 

Kk Restore lower RL 
Restore volume RV 
Set printer echo pat 

K Store lower Oke 
Store volume SY 


KPleagse consult with your SE before using these functions 
Enter options 


The user must mow enter the two-character code of the desired 
option. A response of tEX? terminates the program and returns to 
the environment that was initially cold loaded. If a code is 
entered that is not in the menu List then the message: 


Llleqal option selected 


iS Gutput and the user is reprompted for the aption,. Once a leqal 
option, other than *EX?, has been entered the function is 
invoked, Upon completion, successful or unsuccessful, of the 
function the previously detailed menu i858 output again and the 
user 16 prompted to enter the next option, 

Whenever data must be copied from the fixed platter ta the disc 
carte didga Cor vice versad on a 7906 one of the following messages 
Will be output: 


Function pass number <n> started 
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Where no = 0 means copy original lower to upper backup cartridge 
4. copy original upper to lower platter 
fal copy stored oriqinal upper to cartridae 
3 copy stored original upper to lower platter 
4 copy lower platter data to removable cartridae 
5 copy stored original Lower to lower platter 
& copy original lower to upper platter 
7 copy original lower stored on cartridge to Lower 
platter 


One or more of these messades will be output whenever CC, RL, RY, SL, 
SV is run. These step numbers will make it ensier to determine exact 
what step is being performed by the program, therefore, if an error 
should occur during a copy use the pass number to find out what was 
being done so that the approprinte corrective action can be taken. 


Any T/O errors that are encountered during the execution of a 
function are communicuted to the user through the messages 
detailed in Section 2.0, 


ea .i Copy 7906 Cartridge XKKKKTHTIS FUNCTION SHOULD BE USED IN 
EMERGENCY SITUATIONS ONL YRKKXKX 


This function is invoked whenever the option “CC? is selected, 
"CC? makes copies of one or more 7906 dise cartridges, 


WARNING: because the information to be copied must be written 
down to the Lower platter ALL ORIGINAL LOWER PLATTER 
DATA WILL BE LOST! 


The function initially outputs the message: 

COPY disc CARTRIDGE function now in operation 
and then interacts with the user in the identical manner detailed 
in Analyze Volume (Parngraph 2.4 of Handbook Section 4478) to 
obtain the channel, device, and unit number of the 7906 on which 
the copies are to be made. If the channel, device, and unit 
numbers do mot specify a 7906 then the messaqe: 

Device is mot a 7906 
is output and the function is terminated, If the channel, 


device, and unit numbers specify a 7906 then the following 
interaction occurs: 
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Inquiry: 
Will you please mount the dige cartridge to be copied? 
Valid Response: 
Expecting YES on NO 
A response of NO? outputs the message: 
COPY dise CARTRIDGE terminated by user 
and then terminates the function, A response of “YES? should be 
entered only after the dise cartridge has been mounted, The 
Me BSL | 
Funetion pass No, 4 started 
iS output by the system when “YES? has been entered. Once the 
upper platter has been successfully stored on the lower platter 
the messaqe: 
Upper platter successfully copied to lower platter 
iG output and then the following interaction occurs: 
Inquiry: 


Will you please mount the disc cartridge on which the upper 
platter is to be stored? 


Valid Response: 
Expecting YES or NO 
A response of *’NO’? results in the message which requests you to 
mount the disc cartridge that you want to make a copy of, being 
reissued. A response of “YES? should be made only after the disc 
cartridge has been mounted. Upon entering "YES" the system will 
Gutput the following message: 


Function pass number 4 started. 


Once the lower platter, which now contains the data to be copied, 


Lower platter successfully stored 


is autput and the message which asks you to mount a dise 
cartridge in order to make a copy is reissued. If a "YES" is 
entered anather copy of the lower platter will be made to the new 
cartridge just inserted, Tf "NO" is entered the system reissues 
the question: 
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WL11 you please mount the disc cartridge to be copied. 


A "YES" will cause the function to copy the upper platter to the 
lower platter, A "NO" will terminate the function, 


If awrite error occurs on the upper platter the message: 

Error detected on upper platter, Please remove 
is output and then the user is prompted, with the previously 
detailed mount message, to mount another disc cartridge. To use 
the cartridge just removed the defective track must be found and 
spared or made invisible, The AS function can be used. 
®.2 Clear Printer Echo 


This command disables printer echoing when it is invoked. 


2.3 Copy Volume 
This function is invoked whenever the option ‘CV’ is selected and 
results in the duplication of a volume. The subclasses of the 
volumes must be the same and must reside on separate 7906, 7920 
or 7925 drives. The function initially outputs the message: 
Welcome to the COPY VOLUME function 
Followed by; 
Enter SOURCE volume information 
and then interacts with the user in the identical manner detailed 
in Analyze Volume (Paragraph 2.4 of Handbook Section 447B) to 
obtain the channel, device, and unit number of the source volume. 
It next outputs: 
Enter DESTINATION volume information 


and then interacts as above to obtain the channel, device, and 
unit number of the destination volume. 


If the subclasses are the same and the units are not the same, 
the function starts the duplication; otherwise, the message: 


Tllegal device/unit selected 
4s output and the function is terminated, 
The function will output a single dot on the console for each 


successful I/O transfer of 255 sectors. Upon completion, the 
MeSSsage : 
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Volume copy completed successfully 
Ls output, 


This function can be interrupted by depressing the ATN key or the 
“control y" Ckey on the system console), The message: 


Do you want to abort the volume copy? 


is output. tLeaal response is either “YES’ or ’NO’. If some 
other response is entered, then the message: 


Expectina YES or NO 
Ls output. 
In the Copy Volume function only a retry after a write/verify is 
attempted, If an error is encountered during the first 
write/verify pass the function will output the location of the 
problem and automatically retry, A verify failure during the 
second write/verify pass will stop CV before it completes. 
2.4 Enable Backup System 
This function is invoked whenever the option ‘ER’ is selected and 
results in making the Backup (Secondary) System the Primary 
System and the Primary System the Backup (Secondary) System on a 
SYSTEM volume. The function initially outputs the message: 

ENABLE BACKUP SYSTEM now in operation 

followed by: 

Enter SYSTEM volume information 
and then interacts with the user in the identical manner detailed 
in Analyze Volume (Paragraph 2.4 of Handbook Section 4478) to 
obtain the channel, device, and unit number of the SYSTEM volume 
whose Primary and Backup Systems are to be swapped. Once the 
Systems have been swapped the message: 

ENAELE BACKUP SYSTEM successfully completed 
is output, If the volume is not a system volume the message: 


Volume is not a SYSTEM volume 


is output and the function is terminated. If the volume does not 
have a back-up system, then the message 


Volume has no BACK-UP system 


is output, After the message, 
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ENABLE BACK-UP SYSTEM successfully completed 
LS output the message, 
The PRIMARY (Cor SECONDARY) system is now the CURRENT system 


iS output. 


2.9 Exit 


The selection of the ’EX’ option results in the FMUTILIT program 
being terminated and control returned to BUS. 


2.6 Restore Lower 


This function is invoked whenever the option “RL? is selected. 
It restores the lower platter of a 7906 from the dise cartridge 
on which it was stored with the Store Lower function (Paragraph 
4 PD 


NOTE: Restore Lower is only to be used for the following: 


(14) To recover from a Store Volume (detailed in 2.410) that had 
stored the lower platter and was then abnormally terminated, 


When this occurs you are left with a disc cartridge that 
contains the data stored from the lower platter and a disc. 
cartridae that contains the upper platter data that was never 
successfully stored. The data on these two cartridges are 
matched but because the lower platter was stored on its disc 
cartridge with the partial completion of a Store Volume and 
the disc cartridge that contains the upper platter data was 
not stored with Store Volume the labels on these two platters 
Wildl not match. 


THIS IS THE ONLY TIME THAT YOU SHOULD RESPOND “YES? TO THE 
PROMPT THAT REQUESTS PERMISSTON TO MAKE THE LABELS MATCH. 


(2) To restore data to the lower platter of a 7906 from a disc 
cartridge that was created from the Store Lower function 
detailed in 2.9. 


The function initially outputs the message: 
RESTORE LOWER platter function now in operation 


and then interacts with the user in the identical manner 
described in Analyze Volume (Paragraph 2.41 of Handbook Section 
4478) to obtain the channel, device, and unit number of the 7906, 
If the channel, device, and unit numbers do not specify a 7906 
then the function is terminated. If the channel, device, and 
unit numbers specify a 7906 then the following interaction 
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occurs! 
Inquiry: 


Will you please mount the dise cartridge on which the lower 
platter was stored? 


Valid Response: 
Expecting YES or NO 


A response of ’NO’ terminates the function, A response of ’YES? 
should be entered only after the disc cartridge has been mounted. 


Function pass number 7 started 
is then output by the system as it coples the upper platter to 
the lower platter. Once the platter has been successfully 
restored the messaqde! 
RESTORE LOWER platter successfully completed 
" is output and then the following interaction occurs: 


Inquiry: 


Will you please mount the disc cartridge that contains the 
upper platter data? 


Valid Response: 
‘Expecting YES or NO 
A response of ’NO’ terminates the function. A response of ’YES? 
should be entered only after the disc cartridge has been mounted. 
If you respond “7YES’ without mounting another disc cartridge the 
message: 


Volume label mismatch 


is output and the previously detailed mount message is reissued. 
Once the disc cartridge has been mounted the message: 


RESTORE VOLUME successfully completed 
System can now be cold Loaded 


is output if the data on the upper and lower platters contain 
identical lInbels for a system volume. If the labels do not 
reflect a system volume then the message: 


Volume does not contain a system 
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is output. If the upper and lower platters contain labels for a 
system volume which are not identical then the following 
interaction occurs: 


Inquiry: 
Labels do not match. Do you want them matched? 
Valid Response: 


Expecting YES or NO 


A response of ’NO’ terminates the function with the 7906 
containing data that CANNOT be cold loaded as the data on the 
upper and lower platters will mot match. A response of ’YES?’ 
makes the labels identical and then outputs the message: 


RESTORE volume successfully completed 
System can now be cold londed 


NOTE: A response of YES does not quarrantee that the system will 
work. If the labels do not match it is usually a syptom 
of major systems incompatibility between the upper and 
lower halves of the system, 


2.7 Restore Volume 


This function is invoked whenever the option ‘RV’ is selected. It 
restores a standard volume from a set of flexible discs generated 
with the Store Volume command in the Amigo/300 operating system 
or restores any standard volume stored via the Store Volume 
function described in Paragraph 2.10. Restore volume guarantees 
that the flexible discs and disc cartridges are from the same set 
and may be restored in any order. 


The function initially outputs the message: 
RESTORE VOLUME function now in operation 
followed by: 
Enter DESTINATION volume information 
and then interacts with the user in the identical manner 
described in Analyze Volume (Paragraph 2.4 of Handbook Section 


4478) to obtain the channel, device, and unit number of the 
volume that is to have data restored to it. 


The STORE/RESTORE options allow the user to choose a 
STORE/RESTORE device. Currently devices of class DISC are 
supported. The chart below shows which discs can be used as the 
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source device when Restore Volume is invoked and which can be 
used as the destination. 


DESTINATION 
(Restored To) 


| 7902 . 7906 . 7940 . 7920 . 7925 . 

: 7902 =. MC ee KR. 4 x ; x ‘ H 

» 27906 , e- Xx , x ‘ x ; x % ' 
SOURCE . -_ ; — 
(Restored . 7940 . ‘ ; , , : 
From) a ee 2 ae? 8 

7980. x. Ry KR OR KR, 

. 7925 ., x ‘ x, x , x j x ‘ H 

x: indicates that the restore combination is allowed 
Figure 2.4 ~ Restore Volume Drive Combinations 


When the channel, device, and unit number input indicates that 
the user has selected one of the supported discs the message: 


Please select SOURCE volume (7902, 7906, 7920, 7925) 
is output. 
If a wrong device name is entered, the message: 
Tllegal. device name entered 
is output and the user is again prompted for a legal device name. 
If the user inputs a legal device name, but inputs an address 
which does not correspond to the choosen device name, the 
MmeS Sage } 
Tllegal device address entered 
is output and the menu is again presented, 


The system will now ask for the source volume address information 
as follows: 
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Source and destination devices must not be the same 


Ls output Cunless the device is a 7906) and the menu is output. 
Once valid channel, device, and unit numbers have been specified 
the following interaction occurs: 


Inquiry: 
Will you please mount a STORE volume? 
Valid Response: 
Expecting YES or NO 
A response of ‘NO’ terminates the function. A response of ‘YES? 
should be entered only after a STORE volume has been mounted, A 
STORE/SYSSTORE volume is any media which has been written in the 
STORE/SYSSTORE format, This is the format used when a volume is 
Stored using the STORE VOLUME function, After the Store has 
completed successfully the ASCIT characters "DUMP =" will 


iamedintely precede the label assigned to that volume (except 
when storing a 7906 to itself), 


Once a STORE volume has been successfully mounted the messaqe: 


Volume will be restored from STORE whose ID CODE is <DATE> 
consisting of <NUMBER> STORE volumes 


Will be output where (DATE> is of the format month, day, year, 
time Ca.gq., May f2, 4978, £0:03 AM? if the Amigo/300 SV command 
was used and (NUMBER? is the number of volumes in the STORE set, 
If the volume was stored by the FMUTILIT Store Volume function 
(Paragraph 2,40), then the 20 character ID CODE is output instead 
of the <DATE>). Data is then restored to the volume. When all 
data on the currently mounted STORE volume is restored the 
MESSAGE! 
Processing on current STORE volume completed 
is output followed by: 
Inquiry: 
Will you please mount the next STORE volume? 
Valid Response: 
Expecting YES or NO 
A response of ‘NO’? terminates the function. A response of *YES? 
should be entered only after the next STORE volume has been 
mounted. Once all data has been restored the message: 


RESTORE VOLUME successfully completed 
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is cutput,. One of the following messages will be output and then 
followed by a reissuance of the previously detailed mount message 
whenever a volume is mounted that cannot be used: 

Source volume is not in STORE format 

STORE volume has already been restored 


STORE volume is not part of current STORE set as it belongs to 
STORE whose ID CODE is <DATE> 


STORED volume must be the same subclass 
SYSSTORE volume contains <dev name> data, CANNOT RESTORE, 
Cartridge mounted is part of this STORE (or RESTORE) 


Cartridge is not in SYSSTORE format, Do you want to use the 
volume as a STORE volume? 


The message: 

Flexible disc must be of the same subclass 
is output whenever a single sided flexible disc is mounted during 
a restore from double sided flexible discs and whenever a double 
sided flexible disc is mounted during a restore from single sided: 
flexible discs. <DATE>) will be the date as described above, 


If a 7906 was specified and it is to be restored from disc 
cartridges then the following interaction occurs: 


Inquiry: 


Will you please mount the disc cartridge on which the upper 
platter was stored? 


Valid Response: 
Expecting YES or NO 

A response of NO’? terminates the function, A response of “YES? 
should be entered only after the dise cartridge has been mounted, 
If the disc cartridge mounted does not contain a stored copy of 
upper platter data then the message: 

Disc cartridge does not contain upper platter data 
is output and the previously detailed mount message is reissued. 
If "YES" is entered before the cartridge has been changed then 
the message: 


Disc cartridge was not changed or wrong cartridge mounted, 
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is output and again it asks for the proper cartridge to be 
Mounted. The system then outputs: 


Volume will be restored from STORE whose ID CODE is <xxx> 


Function pass number 3 started, 
The ¢xxx> will be the identification code entered by the user 
when the system was stored using Store Volume. Once the disc 
cartridge has been successfully copied to the lower platter the 
MESsage : 


STORED copy of upper platter successfully copied to lower 
platter 


ise Gutput followed by: 
Inquiry: 


Will you please mount a disc cartridge to which the upper 
platter is to be stored? 


Valid Response: 
Expecting YES or NQ 
A response of °NO’ terminates the function, A reponse of “YES? 
should be entered only after the disc cartridge has been mounted. 
If you respond ’YES? without mounting another dise cartridge the 
MESSage : 


Digc cartridge was not changed or wrong cartridge mounted, 


is output and the previously detailed mount message is reissued, 
If ma write error occurs on the upper platter then the message: 


Error detected on upper platter, Please remove 


is output and the previously detailed mount message is reissued. 
The messaqe: 


Function pass number 4 started 


is issued when the system begins to copy the lower platter to the 
dige cartridge. 


Gnee the lower platter, which now contains a copy of the original 
upper platter is copied the message: 


Upper platter successfully restored 


ig output followed by: 


Inquiry: 
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Will you please mount the disc cartridge on which the Lower 
platter was stored? 


Valid Response: 
Expecting YES or NO 
A response of NO’ terminates the function, A response of *YES? 
should be entered only after the dise cartridge has been mounted. 
If the disc cartridge mounted does not contain a stored copy of 
lower platter data then the message: 
Disc cartridge does not contain lower platter data 


Disc cartridge was not changed or wrong cartridge mounted 


is output and the previously detailed mount message is reissued, 
The message: 


Function pass number S started 


LS output by the system when the system beqins to copy the disc 
cartridge to the lower platter, 


Once the lower platter has been successfully restored the 
message : 


Lower platter successfully restored 
is output followed by: 
Inquiry: 


Will you please mount the dise cartridge to which the upper 
platter was restored? 


Yalid Response: 

Expecting YES or NO 
A response of °’NO’ terminates the function. Tf the wrong 
cartridge is inserted or the cartridge was not changed the 
Messages 

Dise cartridge was not changed or wrong cartridge mounted, 
is output and the previous request is made, A response of ?YES? 
should be entered only after the volume has been mounted. Fhe 


message! 


RESTORE VOLUME successfully completed 
System can now be cold loaded 
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is cgutput if the data on the upper and lower platters contain 
identical labels for a system volume. If the labels do nor 
reflect a system volume then the message: 


Volume labels mismatch 


is output and you do not have a cold loadable system. In either 
case the FMUTILIT menu is output indicating the function has 
completed. 


2.8 Set Printer Echo 


This command enables printer echoing when it is invoked, It 
imtercacts with the user in the same way as the SPE funetion of 
FMDISCUT to obtain the channel and device nunsber of the printer. 
SE initially will output the FMUTILIT funetion menu, From that 
tine until FMUTILIY has been exited or the CE command disables 
echoing, all dialoque will be output to the printer, 


2.9? S$tore Lower 
KKKKKUSE THIS FUNCTION IN EMERGENCY SITUATIONS GNLYXXKKX 


This function is invoked whenever the option “SL? is selected, 
ft Stores the lower platter of a 7906 to a dise cartridge, The 
7906 must contain a standard volume when this function is 
invoked. The function initially outputs the message: 


STORE LOWER platter function now in operation 
and then interacts with the user in the identical manner 
described in Analyze Volume (Paragraph 2.4 of Handbook Section 
447B) to obtain the channel, device, and unit number of the 
volume. If the channel, device, and unit numbers do not specify 
a 7906 then the message: 

Device is not a 7906 
LS output and the function is terminated. If the channel, 
device, and unit numbers specify a 7906 then the volume is 
checked to guarantee that it contains a system. If it does not 
contain a system the messade: 


VYolume label mismatch 


Ls output and the function is terminated. If the volume is a 
standard volume then the following interaction occurs: 


Inquiry: 


Wild you please mount the dise cartridge on which the lower 
platter is to be stored? 
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Valid Response: 
Expecting YES or NO 

A response of @NO’? terminates the function, A response of “YES? 
should be entered only after the dise cartridge has been mounted, 
If you respond “YES? without mounting another dise cartridge the 
MESSaAge 

Digse cartridge was not changed or wrong cartridge mounted, 
if output and the previously detailed mount message i6 reissued, 
After the desired cartridge has been inserted and “YES" has been 
entered the Syatem begins to store the lower platter immediately 
upon issuing the massage: 

Function pass number & started 
QOnee the lower platter has been stored the messaae: 

STORE LOWER platter successfully completed 


ig output, TF a write error occurs on the upper platter the T/0 
error message will be output followed by the message : 


Error detected on upper platter, Please remove 


The previously detailed mount message is then reissued, 


2,40 Store Volume 


This function is invoked whenever the option ‘SV? is selected. 
The function stores a standard volume to a 7902, 7906, 7920, or 
7925 disc drive or stores the upper and lower platters of a 7906 
standard volume to two disc Sora sages: The chart below shows 
which drives may be used as the Source (Stored From) and those 
uged as the Destination (Stored To) volumes, 
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DESTINATION 
(Stored To) 


. 7902 , 7906 . 7940 . 7920 , 7925 . 
» 7902 , ms “4 ; Ma x ‘ H 
» 7906 . | ae x 4 , x. x ; 
SOURCE s t t i) 4 4 ¢ 
(Stored . 7940 , oe x 4 ; M4 4 i 
From) oet?tesestesp#eoee#6¢6¢6¢¢4# 6 @€ @¢ @ @¢ #£ @ @@¢ 6 @ @ © @ @ @ @ @ © 6 6 8 8 8 
» 7920 . K 4 K..4 : K 4 x ' 
| 7925 =. « ‘ x 4 ; x i x ‘ 


indicates that the store combination is allowed 


x! 
(43: 7902 volumes can be stored under Amigo/300 


Figure 2,2 —- Store Volume Drive Combinations 

As mentioned in Section 2,0 the "Function pass..." statement 
indicates where in the Store process one currently is at during a 
STORE/RESTORE from a 7906 to itself (See Section 2.0). 
The function initially outputs the message: 

Store Volume function now in operation 
and then interacts with the user in the identical manner 
described in Analyze Volume (Paragraph 2.4 of Handbook Section 
447%) to obtain the channel, device, and unit numbers of the 
volume to be stored to and from. If the channel, device, and 
unit numbers specify a 7906, and the volume’s label sectors do 
not compare, the message: 

Volume label mismatch 
is output and the function is terminated. Otherwise, a check is 
made to insure that the volume is labelled properly, If not, 
then the message: 

Please use the ’CV? option to copy a NON-STANDARD volume, 


is output and the function is terminated. Otherwise, the system 
issues the following message: 


Please select source volume (7902, 7906, 7920, 7925S) 
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Enter (dev name> STORE volume information 


After the address of the source device is input the system 
follows with the message: 


Please input STORE VOLUME user identification label~--20 
chares 


Valid response: 
any 20 characters 


The Store Volume function will not complete successfully if this 
label typed in is identical to the previous store volume label. 
Therefore, a date and time should be included in the ID label. 
This will prevent the current store operation from accidently 
overwriting a valid store disc, 


meee em ne ee ewe 


If the source and destination devices selected by the addresses 
input are the same the store must be done on a 7906 and the 
interaction proceeds as in paragraphs 2,40.4, otherwise, the 
store is as described in paragraph 2.40.2, 

2.40.4 Store 7906 to itself 

When a 7906 contains a standard volume and it will be both the 
source and destination device the interaction proceeds ag 
follows: 


Inquiry: 


Will you please dismount the disc cartridge and mount another 
cartridge on which the lower platter is to be stored? 


Valid Response: 
Expecting YES or NO 

A response of “NO’ terminates the function. A response of *YES? 
should be eantered only after the disc cartridge has been mounted. 
If you respond “YES? without mounting another disc cartridge the 
MESSAGE: 

Disc cartridge was not changed or wrong cartridge mounted. 
iG output and the previously detailed mount message is reissued, 
If the cartridge inserted is not in the expected format the 
gyatem will output the message: 


Cartridge is not in SYSSTORE format 


Do you want to use the volume as a STORE volume? 
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is output and the previously detailed mount message is reissued, 
The message: 


Function pass number 0 started 


is output by the system as it copies the lower platter to the 
upper platter, 


Once the lower platter has been successfully stored the messaqe: 
Lower platter successfully stored 


is output. At this point you have a dise cartridge which 
contains the stored lower platter data and a dise cartridge that 
contains the upper platter data that has not vet been stored. 


If the Store Volume function does not continue to the point where 
the message "STORE VOLUME successfully completed" is output vou 
Must use the Restore Lower function (Poragraph 2.6) to restore 
the system. If the Store VYolume function does continue to the 
point where the message "STORE VOLUME successfully completed" is 
output then you can use the Restore Volume function (Paragraph 
2.7) te restore the system. However there is an automatic restore 
provided with the Store Volume function which you have the option 
of invoking following output of the message "STORE VOLUME 
successfully completed”. 


After the lower platter is stored the following interaction then 
Occurs: 


Inquiry: 


Will you please mount the dise cartridge which contains the 
upper platter data? 


Valid Response: 
Expecting YES only 
A response af ’YES’ should be entered only after the dige 
cartridge has been mounted. If you respond “YES? without 
Mounting another disc cartridge the message: 


Disc cartridge was not changed or wrong cartridge mounted, 


Ls output and the previously detailed mount messaqe is reissued, 
The message: 


Function pass number 1 started 


is output by the system as it copies the lower platter to the 
upper platter, 


3 
tn 


4470~ 


FMUTILIT ~ OPERATION 


dned dee cere 4960 veae bide 100 dbne Lose dnb EtEe Sens HEED HEED O54 Bebn boLe 4040 Hobe Cube BEEE EEDE Fbee O04 bOED Code SEEE DERE EDHS HEED GObE LURE HOEF 204s Heoe Hebe OeUE FOES EEE DEEd GORE OEE FOND OFFS ude DOE Kune HtED dHDE BREE ERIE DUDE CIEE C50E 400 EdEd Ca0d EDD BODE Dede ObRE EdER Dee HELE OOEs vase UEEE F956 


Once the upper platter has been successfully stored on the lower 
platter the message: 


Upper platter successfully copied to lower platter 
is output followed by: 
Inquiry: 


Will you please mount the dise cartridge on which the upper 
platter is to be stored? 


Valid Response: 
Kxpeating YES only 
A response of *YES? should be entered only after the dise 
cartridge has been mounted, If you respond “YES? without 
Mounting another disc cartridge the message: 


Diga cartridge was not changed or wrong cartridge mounted, 


i% Output and the previously detailed mount message is reissued, 
If a weite error occurs on the upper platter then the message | 


Eeronm detected on upper platter, Please remove 


1@ output and the previously detailed mount message is reissued, 
The message | 


Function pass number 2 started 


Le output by the system ag it copies the lower platter to the 
upper platter, 


Once the lower platter, which now contains a copy of the upper 
platter, has been successfully stored the message: 


STORE volume successfully completed 

LS output. The message: 
RESTORE lower platter phase started 

is output and then the following interaction occurs: 
Inquiry: 


Will you please mount the disc cartridge on which the Lower 
platter was stored? 


Valid Response: 


Expecting YES on NO 
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A response of °NO’? terminates the function and requires you to 
yse the RESTORE VOLUME funetion of FMUTILIT (detailed in 2.7) to 
restore a system to the 7906, A response of ’YES’? should be 
entered only after the dige cartridge has been mounted, If the 
disc cartridge mounted does not contain a stored copy of Lower 
platter data then the message: 

Disa cartridge does not contain lower platter data 


LS output and the previously detailed mount message is reissued, 
After "YES" is antered the message: 


Function pass number 5S started 


is output by the system while the upper platter is being copied 
to the lower platter, 


QOnee the lower platter has been successfully restored the 
ABBSAgE: 


Lower platter guccessfully restored 
ie output followed by: 
Inqudry: 


WiLL you please mount the dige cartridge which contains the 
Upper platter data? 


Valid Response: 
Expecting YES on NO 
A response of ?NO’? terminates the function. A response of *YES? 
should be entered only after the disc cartridge has been mounted, 
Tf you respond “YES? without mounting another disc cartridge the 
ARSSAge : 


Disc cartridge was not changed or wrong cartridge mounted, 


Ls output and the previously detailed mount message is reissued. 
The message: 


RESTORE VOLUME successfully completed System can now be cold 
loaded 


Ls output if the data on the upper and lower platters contain 
identical labels for o system volume. 
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2.40.2 Store to 7902/6/20/25 disc from any disc Cexcept 7902) 


When the source and destination addresses entered do not 
reference the same device the message: 


Next STORE volume on channel mo. ‘c’? device no, ?’d’? unit no. 
Pu? randy? 


is output. A “YES? response will continue the function and a NO 
response will terminate it. 


If the addresses entered do specify the same device and it is not 
mu 7906 the message: 


Seurce and destination devices must not be the same 
ig output and the menu is presented. After the first store disc 
is wreitten and the user does not change the store disc but 


angwers YES’, the following message is output: 


STORE volume on channel ’c’? device ‘dd’? unit *u’? was not 
changed, 


The user is aqain prompted for the next STORE disc. 


[If the dise is not in STORE format (Reference 3.7 for STORE 
format explannationd, the message: 
Volume mounted on channel no. ’c’? device no, ?’d’? unit mo, ?u? 
is mot in STORE format. 


Do you want to use the volume as a STORE volume? 


Le output, If the answer is *YES’, then the function continues, 
Otherwise, the message: 


Next STORE volume on channel mo. °c’? device mo, ?d’? unit no, 
7u? rendy? 


is gaqnin output. A *NO’ response will terminate the function, 
If the new volume is not in STORE format, the above is repented. 


After the user answers “YES? to the question above and the new 
dise volume is found to be in STORE format, the messaqe: 


Volume Store will require xxx STORE volumes 


is output where xxx is the number of volumes required to complete 
the store, 


When storing a 7920 to a 7920 or a 7925 to another 7925 and more 


than 4&4 pack must be used because the pack is completely full the 
MEBSAdE } 
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Please use the CV option to STORE the volume 
will be output and the menu will be presented. 


After the completion of one volume Cother than the above 
Mentioned case), the message: 


Processing of current STORE volume on channel no. ’c? device 
no. ’d? unit mo. *%u? completed 


is output and the above system outputs are repeated starting with 
the message: 


Next STORE volume on channel no. *’c?’? device no. *7d’?’ unit no, 
7u? ready? 


until the entire system volume has been stored. Then the 
Message! 


Volume STORE successfully completed 

Ls output. 

If an error is detected while writing to a volume, the message: 
Bad STORE volume. Please replace 


LG output after the 1/0 error message, The user is then prompted 
to mount the next STORE disc, 
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3.0 ERROR INTERPRETATION 


Tf any I/0 errors are encountered during the execution of any of 
the File Management Utility or Patch Volume functions the user 
Will be informed of the error through one of the messages 
detailed in this section, 


The error messages are divided into correctable errors and 
uncorrectable errors, For a correctable error the user wild be 
informed of the problem and asked to respond “YES? to a prompt 
when the condition has been corrected, If the user responds °ND? 
then the function is terminated and the user is prompted to 
select another function, 


For an uncorrectable error the user is informed of the problem 
and the function is automatically terminated and the user is 
prompted to select another function, The messages are ag 
follows: 


Correctable Errors 


Device on chan/dev/unit is not ready 
Device on chan/dev/Junit is write protected 
Flexible disc mounted is not in HP format 
Turn format switch on ~ chan/dev/unit 


Uncorrectable Errors 


Drive attention on chan/dev/unit 
I/O failed after ’n’? retries 
Device is not a disc 

Device is not a printer 

Channel type is not GIC 

Channel is not present 

I/Q error on chan/dev/unit 
Watchdog timer or parameter error 


followed by: 


Cannot report status 
Cylinder *’c’, head ’h’, sector 7s? 
Relative sector number 7r? 


and then: 


Channel status Status Status2 
(channel (status (status 
status) 4 word) 2 word) 


"“chan/dev/unit" will be the decimal numbers for the 


channel, device, and unit. ?’n’? will be the decimal 


number of retries, '’c’, *h’, ?’s?, and ’r’? are, 
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respectively, the decimal numbers for the cylinder, head, 
sector, and relative sector addressed, 

ALL COPY, STORE, and RESTORE volume commands read/verify every 
data transfer, 


Whenever the system encounters a Dise I/0 error the approprinte 
message Listed above will be followed by a message of the following 
form: 

Disc T/O error xxx-- (text message > 

on device <dey name> ,channel °c’, device ’d’, unit 7u? 

at relative sector z (cylinder ’c’, head ’h’, unit ’u7), 
The error number xxx and (text message> which would be used are 
the same as those output by Amigo/300,. The error numbers and 


messages are listed in Handbook Section 499 ~~ Error and Status 
Codes, 


The messaqde: 

Verification of data written has failed. 
is output by the system if a rend verify of the lower platter of 
ma 7906 has failed (a rend verify is done after every write) . If 
the read verify fails after a write to a removable cartridge the 
above message will be followed by the messuge: 

Error detected on upper platter, Plense remove, 


The function will continue after the cartridge has been replaced, 


If an error occurs and the printer echo is not enabled, the 
MESSAGE ! 


Is the above message recorded? 
is Gutput. The user may wish to record the message and then type 
7¥? or 7N? C?PYES? or °NO?),. If the above is not typed, the 
MESSaqge: 

Expecting YES or NO 


Ls output. 


Following the output of any of the correctable errors the user 
will be prompted with: 


Inquiry: 
Drive ready? 


Valid Response: 
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Expecting YES or NO 
The user should respond *’YES? only after correcting the problem, 
A response of ?NO? results in the function being terminated and 


the user prompted to select another File Management Utility or 
Patch Volume function. 


“~hp- 
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SECTION 447D 


HP 300 FILE MANAGEMENT 
STAND ALONE PATCH VOLUME UTILITY 


CFMPATCHY ) 
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NOTICE 


The information contained in this document is subject to 
change without notice, 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TG THIS MATERTAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE, Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse~ 
quential damages in connection with the furnishing, per~- 
formance or use of this material, 


Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard, 


This document contains proprietary information which is 
protected by copyright. AL] rights are reserved. No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company, 
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4.0 INTRODUCTION 


4.4 Product Abstract 


This document details the external reference specifications for 
FMPATCHY, one of the File Management standalone utilities on the 
HP 300 system, 


4.2 Overview 


File Management provides the user several basic utilities which, 
because of the functions they perform, must be executed in the 
stand alone environment, These utilities are presented to the 
user as options within the FMUTILIT (File Management Utilities), 
FMDISCUT (File Management Volume Utilites), and FMPATCHY (File 
Management Patch Volume) programs which are provided to the user 
om the cold loadable Diagnostic and Utility Package (DUP) 
flexible discs. The intended uses of each program are Listed 
below: 


UTILITY USES 


FMDISCUT: detect and spare bad tracks 
indicate the condition of a surface 
prepare a surface for use 
[covered in Handbook Section 44781 


FMUTILIT: copy non-standard volumes and cartridaes 
back up systems 
Store or Restore information 
replace the primary with the back-up operating system 
[covered in Handbook Section 447C1 


FMPATCHV: inspect or modify the the contents of a volume 


(BUPCE output the contents of m volume in hex, octal or decimal 
only) {covered in this Handbook Section] 


The detnoils of how to load a DUP flexible disc and the 
environment it initially provides the user are described in the 
DUS handbook section (440), This document describes only the 
FMPATCHY programs. 


4.3 Required Hardware 
The HP 300 configuration sufficient to run DUS is required. This 


includes 256 Kbytes of memory, a GIC, CPU, 7902 and an IBS or 
ADCC with a terminal as a console, 
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1.4 Required Software 


The CE Digaaqnostic and Utility Package containing FMPATCHY 
(DUPCE), 
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2,0 OPERATION 


This program is present only on the DUPCE flexible disc and 
enables the CE to display and/or modify any data on a volume 
located in the user arena. Data can optionally be output to a 
printer and can be addressed in a variety of modes. The default 
base for all numeric input and output is hexadecimnalc!), The 
default base for input can be overridden on any input request by 
preceding the numeric value input with a ?#?Cdecimal) or 

** ? Coctal) sign, No documentation of this function is to appear 
in any user manual, 


Onee the DUP flexible disc has been successfully cold loaded and 
the prompt character “:" is present the user must enter FMPATCHY 
to enter the File Management Patch Volume program, 


The program initially outputs the message: 
Welcome to the volume patch utility revision xx.xx 


and then interacts with the user in the identical manner detailed 
in FMDISCUT Analyze Volume [Paragraph 2.4 of Handbook Section 
4478) to obtain the channel, device, and unit number of the 
volume to patch and to get the volume mounted. The menu is 
displayed and the user is then prompted for a command with the 
output of: 


Enter commands: 
If an illegal command is entered the message: 

Tileqal command entered 
is output followed by a prompt for another command, The commands 
and their functions are detailed in gections 2.4 to 2.45. The 


user must enter all three characters of the command mnemonic, 
The following definitions are used throughout this section: 
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> a § BASE-NUM > 


<RGAY__RSA__(BASE-NUM) _} 


ne 


ao 00, as ange S008 ooes wabe ores ante Sone aves see vees cone vere osee ceeD weve wees over 


(CST>_ CST  (BASE-NUM> > 


<DST>__DST__(BASE-NUM> > 


__¢CYLINDER“HEAD-SECTOR> 


Se 


1 
<CHS> CHS (BASE-NUM> of. 
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3. BASE NUM > 


oo ow 


<HEAD“GECTOR) _<BASE-NUM) 
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. SHASE > 


—s we 


<BASE-NUM) __} __¢NUMBER) > 
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(BASE) C!/#/%}___Y 


ot, SOFFSET > 


ea SDESPY 


an oe 
ww 


i 
SPECS) Ot 
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<DISP> <BASE=NUM>_ > 


poet osee 68: 


OFFSET) (BASE-NUM) > 


{COUNT BASE -NUM> > 


e400 sae 


(NUMBER) <DIGIT>$. 


ae. 
(DIGIT). €O/4/2/3/4/3/6/7/8/9/ A/B/C/D/E/F Id 


roo 


mun S GHAR DY 


= on 


(CHAR) SASCIID |} > 


2000 G00e 9000 2000 2508 Suen eoer ence aeee 2008 re 


(ASCII Cany ASCII character} > 


woee ence a0 nee 
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2.4 Choose Address Mode 
The syntax aqraph is: 

ww S CHS 
CRSA | 
ae CCST) 


CAN 2 cet eek DST hau 


ee 


This command allows the user to select the mode in which data is 
to be addressed. The user con select relative sector 
addressC¢CRSAd), cylinder/head/sector address(<(CHS>), code seqment 
table addrass(<CST)) and data segment table address(<DST>)3. The 
default is relative sector address(<¢RSA>) at relative sector 
number OCi.e@., the sector at cylinder 0, head 0, sector 03. The 
UBeEr Teaaing in the selected address mode until another mode i6 
choosen, 


{BASE-NUM> specifies the code seaqment table entry to address in 
CST? addressing mode, the data seqment table entry to address in 
{DST> addressing mode, and the cylinder, head, snd sector to 
address in (CHS> addressing mode. In (CHS> addressing mode the 
address is specifed in the following order: cylinder, head, 
sector. Cylinder address is required and hend and sector will 
defaudt to zero if they are not specified (Note: if head is not 
specified then sector can not be specified). 


If ome (BASE-NUM> is specified for <RSA> addressing then it is 
assumed to be the double word address of the sector to address, 
however, if <BASE-NUM>, <BASE-NUM> is entered then the leftmost 
{BASE~NUM> is taken as the value to enter in the leftmost word of 
the double word sector address and the rightmost <BASE-NUM) is 
taken as the value to enter in the rightmost word of the double 
word sector address, 


The input of an illeqal address mode, illegal numeric value, 
illegal CST number, illegal BST number(Cdata segment numbers in 
the range 22 to !32 inclusive are illegal as these entries are 
used for memory bank addresses and have no dise addresses 
associated with them), om illeqal sector address results, 
respectively, in one of the following messages being output: 


Tilegqal address mode selected 

Tllegal value(s) entered 

Lllegal CST number 

Tlleqgal DST number 

Volume address entered is out of bounds 


followed by the user being prompted to enter another command, If 


{CST> or <DST>) addressing is selected and the volume is mot a 
SYSTEM volume the message: 
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Volume is not a system volume 


is output and the user is then prompted for another command, 


2.2 Clear Print Echo 
The syntax qraph is: 


CPE > 
This command disables the echoing of all data output by the DSP, 
DVD, and BCA commands to a printer, The command is ignored if 
echoing is not currently enabled, 


2.4 Display Current Address 
The syntax graph is: 


DCA} 
This command outputs the current address to the console and 
printer Cif echoing is enabled). The data ouput consists of the 
channel, device, and unit number of the volume being patched, the 
relative gecter number and cylinder, head, sector number of the 
currently addressed sector, and, optionally, the block number Cif 
block addressing had been selected by the SBN command), or the 
CST nusber Cif CST addressing was in effect>d, or the BST number 
Cif DST addressing was in effect). 


All data is output in hexadecimal, octal, and decimal bases 
except the channel, device, and unit number which are output in 
decimal, 
2,4 Disable Decompiler 
The syntax graph is; 

DDC? 
This command allows the user to disable the decompiler so that 
data output by the DSP command if not ouput in decompilded format, 


The command i6 ignored if it is entered when decompiled format is 
already disabled. 
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2.5 Dieplay 
The 8yntax dgraph is: 
OSP SPECS? > 


This command outputs the data specified by (SPECS> from the 
Gurcentiy addressed sector, block, code geqment, or data gseqment 
to the console and printer Cif echoing i6 enabled), 


The data i output in the base specified by the SDE command, 
Hexadecinald!)>, decimal¢#), and octal¢“”s baged output 16 orinted 
46 characters to a line with the address of the data appearing to 
the deft of the Line foldowed by the data iteel fo in the current 
base and then the ASCIT representation of the data Cunprintable 
characters are printed ag ao","), Agedi bagged output i6 printed 
with the address of the data to the left of the Line followed by 
up to 48 ASCIT characters par line, 


(SPECS> defines relative to the start of whatever is currently 
addressed the displacement from which data is to be output and 
the length of the data to output, 


The values for <BASE>, <OFFSET>, and <COUNT>) are taken as bytes 
if the current base is ASCTIICA)D, otherwise, they are taken a8 
words, (COUNT? is optional and defaults to one if not specified, 
OFFSET) and <BASE) are optional, <OFFSET>) defaults to zero when 
not specified. (BASE) defaults to octal. 


The address that appears to the left of each Line displayed is 
output in the display base for all cases except ASCII. In this 
cage the address is output in hexadecimal and reflects the byte 
address of the data being displayed, 


The input of any illegal value for <BASE>, <OQFFSET>, om <CQUNT> 
or a <BASE) and <OFFSET>) whose sum exceeds the end of the current 
sector, code seqment, data seqment, or block results, 
respectively, in the output of one of the following messages: 


Tlleanl value(s) entered. 
Tlleqal starting address entered. 


and the user being prompted for another command, — 
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2.6 Dump Sectors 
The syntax graph is: 


oa BASE “NUM > 


‘ ] 

i] ' 

[ ’ 

i} ' 
1 T aene one 
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DMP 
This command dumps the number of sectors specified by <BASE-~-NUM> 
starting with the currently addressed sector to the console and 
printer dif echoing i6 enabled). Data is output in the same 
format detailed in the DSP command, If <BASE-NUM) is not 
specified then one sector is displayed. 


2,7 Dump Volume Directory 
The syntax graph is: 


DVD... <SPECS>. > 


coco o90e cone 


This command dumps all the uged blocks of the directory to the 
console and printer Cif echoing is enabled), The amount of data to 
be output from each block is specified by <SPECS>, Data is 
output in the same format detailed in the DSP command with the 
exception that each new block that is output is preceded by its 
block number, 


Any invalid data entered for (BASE), (OFFSET), or <COUNT) results 
in the same errors detailed in the DSP command. If the volume is 
not Labelled the message: 


Volume is not labelled. 


ie output and the user is prompted for another command. If the 
current addressing mode is CST or DST then the message: 


Tllegal command for address mode selected 
is output and the user is prompted for another command. If the 
entry contained in the directory which describes the directory 
Ltself can not be found then the message: 


Volume directory is destroyed 


LS output and the user is prompted for another command. 
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2,8 Enable Decompiler 
The syntax graph is: 
EDC. > 


This command allows the user to enable the decompiler so that 
data output by the DSP command i8 output in decompiled format, 
Data output in this manner is displayed two words to the Line 
where each word printed consists of its address and contents in 
the current base followed by its ASCII representation and the 
instruction mnemonics), 


Decompiled output is automatically enabled when <CST> addressing 
ig selected and automatically disabled when any other addressing 
mode is selected. If an EDC command is entered when | 
decaompilation is already enabled it is iqnored, If the EDC 
command is entered in other than <CST) addressing mode it coeuses 
all subsequent data to be displayed in decompiled format, 


e.f Exit 
The syntax graph is: 


EXT? 
This command allows the user to exit the Patch Volume function 
and return to select another File Management Utility function, 


2,40 Modify 
The syntax aqraph is: 
MOD  <¢SPECS> > 


This command allaws the user to modify the contents of a sector, 
block, code segment, or data segment, <BASE> and <OFFSET) detail 
where the modification is to begin and CCOUNT> specifies the 
length of the modification. The input of invalid data for 
CKRASE>, (OFFSET), or <COUNT) results in the same errors detailed 
in the DSP command, 


If the display base is hexadecimal(!), decimal (#), om oetal(%) 
then the address of the data being modified is output, followed 
by the current value of the dataCboth are output in the current 
bauge? to the console. If the display base is ASCII then the byte 
address of the data in hexadecimal followed by up to 20 
chargcters of the data itself is output to the console. 


The user is prompted for the new value by positioning the cursor 


to the right of the current ualue of the data. <BASE), <OFFSET), 
and <COUNT> are taken as bytes if the current addressing mode is 
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ASCII, otherwise , they are taken as words. The user is prompted 
for all new valves until the number of words/bytes specified in 
CCOUNT> have been exhausted. The format of the input is: 


display base is hexadecimal, decimal, or octal 


CBASE-~NUM > RS LENGTH > 


orca ones evne aeee e809 eves eC Or 


“7 


<INPUT) =! 


display base is ASCII 


wen S GHAR > 


-—— om 


CINPUT) oto > 


Tf <BASE-NUM> or (CHAR>D is not specified then the current valve 
is not modified. "R" means repeat and will repeat for the number 
of words specified by LENGTH). If "R" and (LENGTH) are not 
specified only one word is modified. If the display base is 
ASCII and the data to modify contains unprintable characters then 
the message: 


Non-printable characters in string. 


will be ouput and the user prompted for another command, If an 
illegal value is input for <BASE-NUM) or <LENGTH>) the message: 


Tlleqal value(s) entered, 


will be ouput and the user will be reprompted for the patch. If 
{LENGTH applied to the current address of the data being patched 
exceeds the (COUNT) of the modification then the patch will cense 
at the address reflected by the value of <COUNT). If less than 
20 characters are input when the display base is ASCII then the 
string is Left justifed within the data string to patch and 
characters to the right remain unchanged. 


2.44 Next 


The syntax aqraph is: 


This command allows the user to address the next sector, next 
block, next code seqment, or next data seqment. 


The determination of what is next accessed is dependent upon the 
current address mode. The next code segment is addressed if the 
current address mode is <CST>, the next data seqment if the 
current address mode is <DST>, the next block if the current 
address mode is <«CHS> or <(RSA> and. the user has issued a SEN 
command, and the next sector if the current address mode is <CHS> 
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or <RSA> and SBN has not been specified, 


The use of NXT when the last CST is currently addressed, the last 
DST is currently addressed, or the last block or last sector is 
addressed results, respectively, in one of the following messages 
being output: 


Tllegal CST number, 
Illegal DST number. 
Volume address entered is out of bounds, 


and the user prompted for another command. 


2,42 Set Block Number 
The syntax graph is: 


SBN <(BASE-NUM> > 
This command allows the user to specify a block to access 
relative to the current address(relative sector or 
cylinder/head/sector)., <BASE-NUM> specifies the number of the 
block to access relative to the current address. The current 
block is block zero and each block is eight sectors in Length. 


The use of SEN when the current adddressing mode is <CST> or 
<DST>, or the input of an illegal block number or block number 
which exceeds the limits of the volume results, respectively, in 
one of the following messages being output: 


Tlilegal command for addressing mode. 
Tlleqal value(s) entered, 
Volume address entered is out of bounds. 


and the user prompted to enter another command. OQnce block 
number access has been selected it remains in effect until 
another CAM command is entered, 


2,143 Set Display Base 
The syntax graph is: 


SDB. BASE>. > 
This command allows the user to select the display base in which 
all data from the DSP, BYVD, and MOD commands is to be output. 
The default is hexadecimal(!), however, the user can select 
decimal(#), octal(%), or ASCIICA). ALL unprintable characters 
Will be printed as a "." when ASCII has been selected, If an 
illegal base is selected the message: 


Tllegqal display base selected, 
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LS output and the user is prompted for another command, 


2,44 Get Print Echo 
The syntax graph is: 

SPE > 
The successful completion of this command results in the echoing 
of all data output by the DSP, DVD, and DCA commands to a 
printer. Data is output only to the console until this command 


is entered, The command interacts with the user to obtain the 
channel and device number of the printer as follows: 


Inquiry: 
Enter printer’s channel number: 
Valid Response: 
Expecting 4 to 45, 
Inquiry: 
Enter printer’s device number: 
Valid Response: 
Expecting 0 to 7, 
The valves input to these prompts are assumed to be in 
decimal(they can not be entered in any other base). Once the 
channel and device number of o printer have been input printer 


echoing is enabled, 


If the device does not identify itself as a 2634A or 2608A the 
Message : 


Device is not a printer. 


is output, 
2.45 Show 


The syntax graph is: 
SHW > 


oes 008 sane 


This command allows the user to output to the console the list of 
allo valid commands and their parameters to the console. The data 
output is: 
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Choose addressing mode 


Clear print echo 

Display current address 
Disable decompiler 
Display data 

Display volume directory 
Dump sectors 

Enable decompiler 

Exit from volume patch 
Modify data 
Next~sector,block,cst,or dst 
Set block mode addressing 
Set display base 

Set print echo. 

Show list of commands 
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CAM 
CAM 
CAM 
CAM 
CPE 
DCA 
ppc 
DSP 
DUD 
DMP 
EDC 
EXI 
MOD 
NXT 
SEN 
SDB 
SPE 
SHW 


CHS 
CST 
DST 
RSA 


Ccylinderd{,<headd[ ,<sector>] 
{est number > 

Cdst number > 

Csectoridl ,<sector2>] 


[<dispdl+Coffset> TU ,<count>] 
[i<dispdl+<offsetd Tf ,<counto] 
E<count>] 


Ridispdrl+<coffset> TIL, <count>] 


Cblock-number > 
CUSE/Z/ AD 
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3.0 ERROR INTERPRETATION 


If any I/0 errors are encountered during the execution of any of 
the File Management Utility or Patch Volume functions the user 
will be informed of the error throvah cone of the messages 
detatled in this section. 


The error messages are divided into correctable errors and 
uncorrectable errors. For a correctable error the user will be 
informed of the problem and asked to respond ’YES’? to a prompt 
when the condition has been corrected. If the user responds ’NO? 
then the function is terminated and the user is prompted to 
select another function, 


For an uncorrectable error the user is informed of the problem 
and the function is automatically terminated and the user is 
prompted to select another function. The messages are as 
Follows: 


Correctable Errors 


Device on chan/deyv/unit is not ready 
Device on chan/dev/unit is write protected 
Flexible disc mounted is not in HP format 
Turn format switch on - chan/dev/unit 


Uncorrectable Errors 


Drive attention on chan/dev/unit 
{I/O failed after ?n’? retries 
Device is not a disc 

Device is not a printer 

Channel type is not GIC 

Channel is not present 

I/O error on chan/dev/unit 
Watchdog timer or parameter error 


followed by: 
Cannot report status 


GOylinder ’c’, head ’h’, sector. ’?s? 
Relative sector number ?r? 


and then: 
Channel status Status, Status2 
(channel (status (status 
Status) i word) 2 word) 


"chan/deyv/unit" will be the decimal numbers for the channel, 
device, and unit. Tn? will be the decimal number of retries. 
Pe?, *h?, ?s?, and ?’r? are, respectively, the decimal numbers for 
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the cylinder, head, sector, and relative sector addressed. All 
COPY, STORE, and RESTORE volume commands read/verify every data 
transfer, 
Whenever the system encounters a Dige T/0 error the appropriate 
heasage Ligtud above will be followad by & mesunge of the 
following forms - 
Dige [70 error xxxn~™ (text messaged on davice <dev name> 
»channel ’c?, device ?d’?, unit ul at relative sector xz 
Ceylinder ’c?, head ’h’?, unit ?u?), 
The error number xxx and <text message) which would be used are 
the same as those output by Amigo/300. The error numbers and 
messages mre Listed in Handbook Section 199 -~ Error and Status 
Codes. 
The message: 
Verification of data written has foiled, 
is output by the system if a read verify of the lower plintter of 
a 7906 has failed (a read verify is done after every write) . If 
the read verify fails after a write to a removable cartridge the 
above message will be followed by the message: 
Error detected on upper platter, Please remove, 
The function will continue after the cartridge has been replaced, 


Tf an error occurs and the printer echo is not enabled, the 
MESSage } 


Is the above message recorded? 
is output. The user may wish to record the message and then type 
7¥* or 7N? CPYES? or °NO?7)>,. If the above is not typed, the 
message: 

Expecting YES or NO 
is output, 


Following the output of any of the correctable errors the user 
Will be prompted with: 


Inquiry: 
Drive ready? 


Valid Response: 


Expecting YES or NO 
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The user should respond “YES’ only after correcting the problem. 
A response of 7NO’? results in the funetion being terminated and 
the user prompted to select another File Management Utility or 
Patch Volume function, 
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NOTICE 


The information contained in this document is subject to 
change without notice. 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD 
TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE. Hewlett-Packard shall not be liable 
for errors contained herein or for incidental or conse~ 
quential damages in connection with the furnishing, per 
formance or use of this material, 


Hewlett-Packard assumes no responsibility for the use or 
reliability of its software on equipment that is not fur- 
nished by Hewlett-Packard, 


This document contains proprietary information which is 
protected by copyright, All rights are reserved. No 
part of this document may be photocopied, reproduced or 
translated to another program language without the prior 
written consent of Hewlett-Packard Company. 
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2 SCRIPT2 (More extensive) 
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TASK4 
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4.0 WORKOUTS00 OVERVIEW 


Purpose: WORKOUTS00 uses system services to test system access 
to peripherals under a normal or heavy system lond 
environment. Ey peripheral access, one means using the 
physical interconnections between the peripherals and 
the system. Ey system services, one means the software 
Services available to the user through the intrinsic 
calis, 


WORKGUTSO0 currently enables a user to selectively exercise any 
or all of the following peripherals attached to the HP 300: IDS, 
any disc, any non menu terminal, any printer. 


The heart of WORKOUTSO0 is a collection of functions that 
individually exercise certain portions of the operating system 
and/or peripherals, 


Throvah a user supplied script, these functions Cand/or user 
supplied programs) will be selectively run serially and/or 
concurrently. 


WORKOUTSO0 builds an exercising environment according to this 
user supplied script. The script gives the user the option of 1} 
constructing or not constructing a multitasking and/or 
mMultiprogramming environment, 2) specifying which peripherals are 
to be exercised, including/excluding the IDS. 


In addition to WORKOUT300 supplied functions, the user has the 
option of specifying his own program in the script file. The 
program will be PLOADed by WORKOUTS00 and launched into execution 
according to the script. 


WORKOUTSO0 is written in BASIC and runs under the operating 
system in non-privileged mode, 
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2.0 THE SCRIPT LANGUAGE 


The script language allows two levels of concurrency: 
unsynchronized global concurrency and synchronized local 
concurrency. 


Local concurrency allows the user to form groups of tasks and/or 
programs. All tasks/programs within an active group begin 


execution at the same time and run concurrently. All 
tasks/programs within the active group must terminate before the 
next group becomes active. In this way concurrency is 


synchronized at the beginning of an active aroup, 


Global concurrency allows the user to form collections of groups, 
Each collection runs with local concurrency amongst its menber 
groups, as described above, while all the collections run 
concurrently and independently. The only synchronization between 
the collections is that they all start execution at the same 
time, 


Backward branching capabilities within a collection exists, 
allowing a sequence of groups to be executed repentedly, 
indefinitely. Forward branching capabilities do not exist. Such 
a branch would not be useful since decision capabilities do not 
exist, 


Script Language Syntax 


Pees ORSe enee Bee Oneh S562 BFE 2408 Suns SEDs BEEe eEbe Sete Gere Bees OEEe Shee e280 e180 


Declaration Block 


we me 
a ee ee 


4000 pees seas Bene 220s BOND oEEe shes CHEE GouD eee Cone Bree Onee Bene SORE SODe Stes SEEe 
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COLLECTION 4 


CS ee 
ew wm 
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COLLECTION 2 


we ee en 
2 i ew 
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2.4 Declaration Block 


The declaration block is the reqion of the script that associntes 
task identifiers with WORKOUT300 supplied functions and program 
identifiers with user supplied programs. These terms are defined 
below. The declaration block appears at the beginning of the 
script and consists of a non-empty List of declarations. 


Task or program identifiers, once declared, can be used any 

number of times in any number of collections. Furthermore, a 

single WORKOUT300 supplied function or user supplied program can i 
be associated with any number of identifiers. This allows a 

single function or program to run with different parameters in a 
multi-tasking and/or multiprogramming mode. Hence one can have 

the following: 


TA:=TASKIC, ,40000,2] 
T2:=TASKIC, ,5000,4) 
COLLECTION 
TA,7T4,T1,T1,T2 


T2 


2.4.4 WORKOUT300 Supplied Functions: 


Tni:=TASKmE <parameter List>] 


where 


nym are 4, 2, or 3 digit numbers. 


Tn is the task identifier associated with the TASKmaL...3 
function specification and used to refer to this specification 
in the collection blocks, 


TASKm is a WORKOUTS00 supplied function name. For a list of 
existing functions see Section 6.0 below. The writeup on each 
Exerciser function describes its operation and functional 
parameters, 


~~ Oe 


(parameter list> is a list of functional parameters to be } 
passed to the function when TSTARTed (see writeup on H 
individual exerciser functions), 


EXAMPLE : 


T4:=TASKSE I 
TI7:=TASK4SE TERMS 2,13) 


The square brackets enclosing the parameter field are a 

necessary part of the script language syntax. Even if all default 
values are assumed and the parameter field is empty, the square 
brackets must be present. 
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2.4.2 User Supplied Programs: 
Phi=programnamel(parameter List>] 
where 
nis a4, 2, or 3 digit number, 
Pn is the program identifier associated with the 
programnamel,..] specification and used to refer to this 


specification in the collection blocks, 


programname is a fully qualified user program workspace name 
to be PLOADed and PSTARTed by WORKOUTSOO, 


{parameter list) is the list of parameters to be passed to the 
user program via the PARMS parameter of the PSTART system 
intringic. This information is available to the program via 
the BGETPARMS intrinsic (see Section 5.3), 


EXAMPLE: 

P32; IOEXER (DIAG). (DSKOV) CINFILECMYDOM).(DSFLOP),,,33,23 
The scquare brackets enclosing the parameter field are a necessary 
part of the script language syntax. Even if all default valves 
are assumed and the parameter field is empty, the square brackets 


MUSt be present, 


For more information concerning subprograms running under 
WORKOUT300, see Section $5.0, 


MAY 6, 19814 448~- 


er ew WY oo 


we = os 


7 


WORKOUT300 ~- THE SCRIPT LANGUAGE 


Abt YUPO CORE CUES SEHE GONE COED BELL DEFT EHD HFEF OIE AEE FIED FEES BOLE DOSE BLOT FORE BORE GOSS YORE DERE SEOP ODES HUEY BESS LEED SeEe EOD ONDE BhBE EEED ONLY ERED COED DEM DIE: GENE Sone LESE CEOS OFOE OOEe CECE EROE CEDT OREL EERO 4994 HOES OOns HOES BEFF ODED FED FEE FORE CEO S000 SEED BOLE HOOP EDD UNE POOH SORE CEE SHE case O88 E800 


2.2 Collections 


an see 


Collections are non-empty lists of groups, beginning with a 
COLLECTION statement, and ending with either a group or a GOTO 
Statement, AlL collections run concurrently and unsynchronized 
(they all start at the same time, however.) A current maximum of 
ten collections may be defined in a script, 
COLLECTION: 

COLLECTION Ccomment] 

Groupi 

Groupe 


COLLECTION {commenti 


Groupi 
Groupe 


where 


comment is any user supplied message. It is optional and can 
be used for documentation purposes, 


Groupi, Groupe, ..,. aré non-empty lists of program or task 
identifiers separated by commas (Groups are defined below), 
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EXAMPLE: 


COLLECTION IQ TESTER 

Ti, 17, T2, P4, P4, T3 

P4,P4,P4 

P4 

T4, P3, Th 

COLLECTION DEVICE EXERCISER 


iS Te 
T2, 3, T7 
GOTO 15 


2,5 Groups 


A aroup is a list of one or more (previously defined) 
task/program identifiers, possibly preceded by a line number. A 
group occupies one line of script. All functions and/or prograns 
associated with the identifiers in an active qroup run 
concurrently, a11 starting approximately at the same time, The 
next group in the collection will not become active until all 
tasks/programs in the currently active group have finished 
executing. There is a current maximum of twenty identifiers per 
aroup. 


Identifiers within a group must be separated by commas. A group 
cannot end in a comma, 
Group: 
Clabell] identifier, identifier, ..., identifier 
where 


label is optional and consists of a unique (within current 
collection) £4 or 2 digit number followed by a blank, 


identifier is a task/proaqram identifier declared in the 
DECLARATION BLOCK. 


EXAMPLE: 


T4, T7, P44, T3 
45 13, 17 
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NOTE: The difference between 


COLLECTION 
Ti, Te, TS 


and 


COLLECTION 
Ti 
Te 
T3 


is that, in the first instance, WORKOUTS00 functions 
associated with the task identifiers Ti, Téa, and T3 are 
run concurrently (since all are within the same group), 
In the second instance, the functions are run serially 
(since each is in a different group), 


aw woe 


2.4 GOTOs 


A GOTO statement directs WORKOUTS00 operation to a previously H 
defined group within the same collection, The presence of o GOTO 

in a collection establishes an indefinite looping pEENGTECD: the 
collection will never terminate on its own, 


GOTO: 
GOTO label 
where label is a label previously defined in the current 
COLLECTION and consisting of a 1 or 2 digit number. 
EXAMPLE : 
GOTG 14 
Note: Since no decision making is possible in the script 
language, more than one GOTO statement per collection 
Will not result in a meaningful script, Since GOTOs 
must reference back, all groups following a GOTO 


within a collection will not be used, A GOTO results 
in indefinite looping. 
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3.0 QPERATING INSTRUCTIONS 


The script needs to exist prior to execution of WORKOUTSO0 due to 
the inability of WORKOUT300 to interactively build a script. 
There are at least two ways to build a script. First, one could 
start with one of the standard scripts and modify it 
appropriately in the WORKOUT3S00 environment. Second, one could 
use the TYPIST subsystem to create the script from scratch. 


If a script has been created from scratch (the second method), 
then one must issue the command 


COPY MODULE modulename TO UNN FILE scriptfilename 
while in TYPIST in order to get the necessary sequential file 
containing the script, This script can again be modified while 
in the WORKOUTS00 environment. 
The standard scripts and the WORKOUT3O0 program are located on a 
store volume floppy. To load the program and standard scripts 
into the system, issve the following AMIGO commands while the 
WORKOUTSO0O floppy is in the floppy drive: 

ID PUBLIC 

RESTORE WORKSPACE WORKOUT FROM FLEXDISC 

RESTORE FILE SCRIPT£ FROM FLEXDISC 

RESTORE FILE SCRIPT2 FROM FLEXDISC 


If the user does not intend on using one of the standard scripts, 
the last two RESTORE commands need not be issued. 


The script file name can be communicated to WORKOUT300 in a 
variety of ways: 


(4) by the USING parameter of the run command: 
RUN WORKOUT USING scriptfilename 
(2) by EQUATING file SCRIPT with the actual script file name: 
EQUATE FILE SCRIPT TO scriptfilename 
RUN WORKOUT 
(3) by being prompted by WORKOUT300 via ASKOP 
RUN WORKOUT 
ASKOP message: PLEASE ENTER SCRIPT FILE NAME 
User response: REPLY scriptfilename 
WORKOUTSO0 next attempts to crente a keyed sequential file by the 


nane SXLOGCPUBLIC) to serve as the disc log file. If a file by 
this name already exists at WORKOUT300 run time, then WORKOUTS00 
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will ASKOP permission to destroy the file and recreate it type 
keyed sequential. If a negative response is given to this 
request, WORKOUT300 will prompt for a new file name (fully 
qualified or default to current domain), 


a 


Once the source file for the script and the disc log file have 

been determined, WORKOUTS00 will scan the script for errors and | H 
display the script on the IDS. 

If errors are encountered, WORKOUT300 will prompt the user for a H 
correction. If all corrections are made, or if no errors were 
encountered, the entire script will be displayed on the IDS and 
WORKOUT300 will enter a state in which the user can modify the H 
script. 


At this point the user can do anything to the script with the 
exception of inserting lines. 


NOTE: If all groups of a collection have been deleted, then 
the collection statement must also be deleted. 


Two softkeys are enabled: 


(4) START WORKOUT causes WORKOUT300 to rescan the script and H 
start the exercise. 


(2) ABORT WORKOUT causes WORKOUT3Z00 to abort. 


EXAMPLE 
To run the default script SCRIPT: 


Restore the workspace WORKOUT and the file SCRIPTi as indicated 
above. 


PURGE FILE SXLOGC(PUBLIC) ... if it exists already 
RUN WORKOUT USING SCRIPTi 


When the windows for the program appear, press the softkey 
labeled START WORKOUT. WORKOUT3S00 should run to completion. 


NOTE: If the printer test is not to be run, or if the device 
name of the printer is different than “PRINTER", then the script 
will have to be modified. 
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4.0 OUTPUT FROM WORKOUTIO0 


Output from WORKOUTS0O0 comes in a variety of forms: as IDS 
displays, called Exerciser State Displays; and as log file 
output. 


4.4 WORKOUT300 State Displays 


There are currently two state-of~the-exerciser IDS displays 
available; the STATUS display and the LOGFILE display. 
Switching from one to the other (as well as aborting and 
backgrounding WORKOUT300) is accomplished interactively through 
labelled softkeys. 


4.4.4 The STATUS Display State 


The STATUS display displays the script using video enhancements 
to indicate the “state" of WORKOUT300. Ench identifier in every 
group in all collections of the script is in exactly one of three 
states: 


(1) Currently executing (Logged on), Here the identifier is 
displayed in inverse video. See section S.2.141. 


(2) Queved for execution (TSTARTed or PSTARTed) but not yet 
logged-on. Here the identifier is blinking. 


(3) Not queved and not logged on. Here the identifier is not 
enhanced, 


The status window is opened scrollable for horizontal scrolling. 
Vertical scrolling should be accomplished via the softkey 
options. This avoids having the window repositioned whenever a 
State change occurs in a portion of the script not currently 
displayed in the window. 


4.4.2 The LOGFILE Display State 


The LOGFILE display displays the contents of the disc log file. 
This window is opened scrollable to allow examination of any 


portion of the file. 


4.1.3 The BACKGROUND State 


WORKOUTSO00 defaults to the foreground position; i.e., status 
displayed on the IDS. Except when an IDS exerciser function is 
exercising the IDS, the user has the option of forcing WORKOUT3O0 
into a state where the IDS can be reallocated to another job 
without hanging WORKOUT300. This state is called "BACKGROUND" 
and can be accomplished by depressing the "BACKGROUND" labelled 
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softkey. Therefore, to prevent WORKOUT300 from hanging in an 
attempt to update an IDS that is elsewhere allocated, WORKOUTS00 
should be put into background prior to interrupting into the 
AMIGO environment. 


When in background mode, the IDS displays an environment window 
CWORKOUT3S0O0 environment) and a softkey window. These softkeys t 
are armed to allow the user to either enter forearound mode (SHOW 
STATUS), or to abort WORKOUTS00 (ABORT). 


we ee Ne ee mw 


4,2 WORKOUTSO0 Log 


Each task logs into a memory file whenever it calls an intrinsic 
or returns from a call to an intrinsic. Only if an error is 
detected during the call is a permanent record put on disc, 
Otherwise the disc log file contains the log on and log off 
messages from the tasks and programs. 


Whenever possible, recovery from a detected error is attempted, 
If in a single exerciser task, the total number of detected 
errors exceeds a certain maximum (currently 10), then the task 
Will self-abort. If in a task an error occurs that is critical 
to the operation of the task (such as opening the device) then 
the task will again abort. If an error is detected in a task or 
in any of the control tasks making up WORKOUT300, and the call is 
critical to the operation of WORKOUTS00 as a whole, then 
WORKOUTSO0 wild abort and an error message will be TELLOPed to 
the console. 


=e me 


This message will contain the error condition (STATUS) and error 
message, name of the routine where the intrinsic call occurred, 
and the intrinsic called. 


If a non-zero status is returned from the intrinsic, the 

parameter values used in the call will be written to the memory 

file. A WORKOUT3Z0O0 control task reads this data from the memory { 
file, and writes it to the disc log file. 


The memory file will be available for output from user supplied 
programs operating under the WORKOUTS00 system. The proper 
format for records written into this memory file is documented 
below in Section $.2, 
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$.0 ADVANCED USAGE ~- RUNNING SUBORDINATE PROGRAMS 


The user has the option of having WORKOUT300 load and execute a 
user program via the program identifiers in the seript. These 
programs are called subordinate programs, 


5.4 Communication from WORKOUTS00 to Subordinate Program 


Each exercising function task and subordinate program TCREATEd 
and TSTARTed or PLOADed and PSTARTed by WORKOUT300 is assigned a 
unique key to be used by these tasks and programs for 
communication with the WORKOUT300 control program. 


For user supplied programs, this key is passed to the program via 
the PARMS parameter of the PSTART command along with the other 
program parameters specified in the program identifier . 
declaration. The program acquires this key and its other 
parameters by calling the system intrinsic BGETPARMS. For 
example, consider the following script: 


P44:=MYPROG(KOV) [LINFILE (SCRATCH) ,S,,4] 
COLLECTION 
P44 


When MYPROG ICALL’s the system intrinsic BGETPARMS, a typical 
response would the following: 


"44,0,417,INFILE (SCRATCH) ,5, ,4" 


where the first three numbers represent the key passed to the 
user program by the WORKOUT300 control program. The key contains 
the program identifier, collection number (zero origin), and 
program ID number (and possibly a fourth number. See Section 
$.2.5.) 


5.2 Communication from the Subordinate Program to the Logger 
Control Task 


As stated in Section 5,2 the key is used to identify the source 
of any message sent to the WORKOUT300 control program. It is the 
responsibility of the user subordinate program to send the 
following communication: 


(4) LOG ON. 

(2) LOG OFF 

(3) ERROR REPORTS 

All communication is sent to the memory file 


LOGFILE. MEMORY 


oF OS? ee, « 
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Which has already been created by the time the user program 
begins execution. The user must therefore open this memory file 
shared update by issuing a command like the following: 


ICALL OPENC"LOGFILE.MEMORY",414, MEMFILE. FID, STATUS(), SHARE: 
MyM 3 


All communication written to the memory log file LOGFILE. MEMORY 

is read by the logger control task. In order for the logger to H 
act upon the communication, the communication must observe the 
following format Cexcept for ERROR-CONTINUATION messages. See 

Section 5.2.8): 


OPCODE , KEY ,PARAMETERS 


where 
OPCODE is a number that identifies the operation being 
requested 
KEY is the three tuple (or four tuple if subtask, 


See SUBTASK-LOGON, Sec. $.2.5) that is passed to 
the user program via the PARMS parameter of the 
PSTART intrinsic (see aboved. 


PARAMETERS is a possibly empty list of additional items, 
the content of which depends upon the OPCODE. 


All messages sent to LOGFILE .MEMORY that do not observe this 
format will be dumped into the disc log file. For a11 such 
"unformatted messages", CARE MUST BE TAKEN TO PREFIX THE MESSAGE 
WITH A NON-NUMERIC, NON-BLANK CHARACTER. Random OPCODES can have 
a very serious effect on the operation of WORKOUT300 as a whole. H 


The current logger control task operations are the following: 


5.2@.4 LOG-ON 


OPCODE: 0 
KEY: three-tuple only 
PARAMETERS: None 


A function task or subordinate program sends this message to the 
log memory file to notify WORKOUT300 that the funetion/program 
has begun execution. 


—— me me 


EXAMPLE: "0,44,0,47" 


5.2.2 LOG-OFF 
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OPCODE : 4 
KEY: three-tuple only 
PARAMETERS: None 


A function task or subordinate program sends this message to 
notify WORKOUTSO0 that the function/program is about to 
terminate, 


EXAMPLE : "4,44,0,47" 


$.2,.3 START-ICALL 


OPCODE: 2 
KEY: three-tuple or four~-touple 
PARAMETERS: INTRINGIC 


The function task or subordinate program is about to [CALL a 
system intrinsic, This communication serves the purpose of 
telling WORKOUTSO0 which intrinsic is being called, H 


EXAMPLE: "2,14,0,147,GETN.1" for a three-tuple KEY 
"2,14,0,23,47,GETN.41" for a four-tuple key 


NOTE. 


The INTRINSIC parameter is treated as a string by 
WORKOUT3S00 and is stored temporarily until a 
STOP-ICALL or ERROR message is issued. It is not 
tested for content. The INTRINSIC parameter will be 
ysed when recording an error in the logger disc file. 
This parameter may therefore contain information 
useful for identifying which intrinsic coused the 
error. Hence GETN.4 may be used rather than just 
GETN in order to uniquely identify which GETN issued 
the message (assuming multiple GETN calls in the user 
subordinate program). 


S$.2.4 STOP-ICALL 


OPCODE ; 3. 
KEY: three-tuple or four-tuple 
PARAMETERS: None 


This message is paired with a START ICALL message and notifies 
WORKOUTSO0 that the intrinsic called has completed successfully 
(zaro status returned), 


EXAMPLE: "3,44,0,417" for a three-tuple KEY 
"3,44,0,23,417" for a four-tuple KEY 
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S.2.% SUBTASK-LOG~ON 


QOPCODE: 7 
KEY: four-tuple only 
PARAMETERS: None 


A function task om subordinate program has TCREATEd and TSTARTed 
another task op PLOADed and PSTARTed another program, This 
subtask/subprogram logs on via the SUBTASK<LOG"ON message. For 
such a subtask, KEY ig¢ now a four-tuple: PROGRAM IDENTIFIER (of 
parent task/program), COLLECTION NUMBER, ID (of TSTARTed subtask 
or PSTARTed subprogram), PARENT ID (of calling task/program), 

For instance, suppose a task with KEY="44,0,47" TSTARTs a subtask 
with task ID 23. Then the subtask would adopt the KEY 


14,0,23,417 
and would use this KEY for all communication with WORKOUTSO0, 


EXAMPLE: "7,44,0,23,47" 


$.2.& SURTASK-LOG~OFF 


OPCODE: 8 
KEY: four-tuple only 
PARAMETERS: None 


A subtask or subprogram (see SUBTASK~LOG~-ON, Section 5.2.5) sends 
the message to notify WORKOUTS00 that it is about to terminate 
execution. 


EXAMPLE: "8,414,0,23,47" 


5.2.7 ERROR 


OPCODE: 9 
KEY: three-tuple or four-tuple 
PARAMETERS: STATUS(CO) ,STATUS(4) ,ITCALL PARAMETERS 


A system intrinsic (see START-ICALL, Sec, 5.2.3) returns with a 
non-zero status indicating an error, The task/program sends the 
error message to supply error report information about the TCALL 
and to have WORKOUTS0O0 generate an error message in the 
WORKOUTSO0 disc log file. This message also notifies the 
WORKOUT3O0 of the termination of the intrinsic, making a 
STOP-ICALL message unnecessary; i.e., this message is also paired 
with a START-ICALL message, but only in the event of an error 
return from the intrinsic. 


The ICALL PARAMETERS portion of the parameter list is a possibly 


empty list of the parameters used in the ICALL and is treated as 
ma comment string by the logger~control task. 
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EXAMPLE: "9,44,0,47,2,~-44044,PROGID:60" for a three-tuple KEY 
"9 ,44,0,23,47,2,-44044,PROGID:60" for a four~tuple KEY 


$.2,8 ERROR-CONTINUATION 


OPCODE: 40 
KEY: None 
PARAMETERS: ICALL PARAMETERS 


This message serves as a continuation of an ERROR message and is 
used when the ERROR message alone would otherwise exceed 254 
characters. To use this message, the LOGFILE.MEMORY must not he 
FUNLOCKed between the ERROR message and the ERROR-CONTINUATION 
message nor between multiple ERROR-CONTINUATION messages, 


This guarantees that the ERROR message and its continuation 
messages will appear contiguously in the LOGFILE.MEMORY file. 


NOTE: The ERROR-CONTINUATION messages should not contain a 
KEY. 


EXAMPLE: "9,414,0,47,24,-1000 ,WNDID:77,ROW:2,INVDEO: 0" 


"40 ,HALFB:4,BLINK; 4" 
"4$0,UNDLINE: 0" 
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6,0 EXERCISER FUNCTIONS 
Exerciser functions are procedures available to the user for 
the purpose of exercising certain peripherals. These are linked 
to task identifiers in the task declarations of the script. They 
are referenced in these task declarations by 
TASK 

where n is from i to 4, inclusive. 
The four functions are the following: 

(4) Generalized Disc exerciser 

(2) Printer exerciser 


(3) IDS exerciser 
(4) Generalized terminal I/0 exerciser 
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6.4 Dise Exerciser Function Task: TASKS 


The Dise Exerciser Function Task will exercise a 7902, 7906, 
79410, 7920, or 7925 disc unit containing either the system disc 
or a standard volume. This is done by reading and writing from 
and to exerciser created work files. Verification of the 
contents written to a work file is also performed. 


TASKS (DOMAIN, DEVICE NAME ,VOLUME NAME ,NUM_ RECORDS ,NUM CYCLES] 
Parameters: 


DOMAIN Specifies an existing domain name where the DEFT 
Will create its work files. The default value is 
"SCRATCH", 


DEVICE Specifies the device where the above specified 
domain resides. (This name, associated with the 
disc device, can be found by issuing the command 
SHOW STATUS GF ALL DEVICES. Default is ""3 i.e., 
the system disc. 


VOLUME Specifies the name of the volume where the above 
specified domain resides. Default is ""s i.e8., 
the system volume, Note: If the VOLUME parameter 
is left to default, the DEFT will force the DEVICE 
parameter to default overriding any specified 
device, 


NUM _ RECORDS Specifies the number of records initially 
deposited in the source file. This will be the 
number of records copied between files and the 
number of comparisons between files. Default 
value is 1000. 


NUM CYCLES Specifies the number of 
read-write-read-read-compare cycles to perform. 
If negative, TASKS will cycle indefinitely, 
Default is 4 Cone cycle), 


At any one time, there will be at most 3 files beina managed by 
the TASKS: a source file, a destination file, and an intermediate 


File. If more than one cycle is specified, the role of each 
file, whether source, destination or intermediate will change 
With time. This will become clearer from what follows. Currently 


only the Device Management functions have been implemented. 


The TASK performs the following: 
INITIAL SETUP; 


(4) Create a relative file in the desianated or default domain. 
This file will be the source file. 
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(2) Fill up the source file with records of lengths varying 
between 4 and 254 bytes, inclusive. The number of records is 
specified in NUM _RECORDS. 


(3) Create a second relative file in the desiqnated or default 
domain. This file will be the destination file. 


CYCLE STEPS: 


(4) Copy records sequentially, one at a time, from the source 
file to the destination file. 


(5) Read records from the source file and compare them with 
records read from the destination file. 


If the specified number of cycles has been performed, then TASK4 
purges all files and exits. Otherwise, the following next cycle 
setup steps are performed, 

NEXT CYCLE SETUP: 


(6) Create a third relative file on the desiaqnated or default 
domain to serve as the intermediate file. 


(7) Purge the current source file 
(8) The previous destination file now serves as the new source 
file, and the intermediate file now serves as the new 
destination file, 
(9) Continue with step 4 above, 
EXAMPLE : 
TS: = TASKALTESTDOM, ,DSSYSTST,2500 ,101 
Here all work files will be created in the domain TESTDOM on the 
floppy volume DSSYSTST, The initial source file will be filled 
with 2500 records and the TASKL will cycle 10 times, 
EXAMPLE: 
TASKAL 1 is equivalent to 


TASKAC SCRATCH, DISC7906, D6SYS,1000,4) 


for a 7906 based system, with volume label D&SYS and device name 
DISC79O6, or 


TASKAT SCRATCH, DISC7910,DiSYS,1000,41 


for a 7940 based system with volume label DISYS and device name 
DISC7910, 
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6.2 Printer Exerciser Function Task: TASK2 


The Printer Exerciser Function Task will exercise any 2634 or 
2608 printer attached to the HP 300, The exerciser will print a 
series of print tests on the printer that can easily be scanned 
for printer errors. Errors detected by the system intrinsics 
will be reported in the log file. For a 2631, one TASK2 cycle 
produces 12 pages of output, and take about 15 minutes to 
complete. For a 2608, one cycle produces 2 pages of output and 
takes a few minutes to complete, 


TASK @2C DEVICE _ NAME ,NUM_ CYCLES ,PRINT_ WIDTH, SECONDARY] 


Parameters: 
DEVICE NAME. Specifies the name associated with the printer. 
Default is "PRINTER". H 
> 
NUM CYCLES Specifies the number of tines the TASK2 will 
loop through the printer exerciser tests, If 
negative, TASK2 will cycle indefinitely, 
Default is i. 
PRINT WIDTH Specifies the maximum number of characters that 
can be printed per line while in norsal print 
mode (40 cpid. Default is 136. 
SECONDARY Specifies whether a secondary character set 


exists and if so whether or not to exercise it. 
If the SECONDARY parameter is non-zero, then a 
secondary character set is assumed to exist and 
Will be exercised using the same print tests ag 
used for the primary, Default is zero. 


NOTE: Multiple copies of the printer exercisor task can execute 
concurrently on the same printer only if the printer is SPOOLED, 
It is possible to write a script using this task which will 
execute correctly on a system with a spooled printer which will 
execute with errors on a system with the same printer un-spooled, 


o@w awe we eww ww ae oe 
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6.3 IDS Exerciser Function Task: TASKS 


TASKS performs several tests that exercise various IDS manaaement 
intringsics, These tests exercise alternate character sets Cwhen 
specified), enhancement options, and all four window types. 


TASK SLI DEVICE. NAME ,ALTCHARSET} 
Parameters: 


DEVICE. NAME Specifies the name associated with the IDS. 
Default is “CONGOLE", 


AL. TCHARSET Specifies the alternate character sets to be 
tested. This parameter consists of ai, 2, or 
3 digit number Cor omitted of no alternate 
character sets). If a "4" appears as any one 
of the digits in this number, then the Altih 
character set will be assumed to exist. 
Similarly for the digit "2" and "3". Therefore 
ALTCHARSET = 342 will be equivalent to i123, 
243, 324, etc,., and will exercise all three 
alternate character sets. 


The first IDS exerciser test has the screen split into a softkey 

window and an Implicit window. The Implicit window is exercised 

by a sepnrate subtask that writes a print pattern sequentially to 
the window, applying varying enhancement options to the lines in 

the window, 


The second test splits the screen into a softkey window, an 
Implicit window, and Explicit window, and an unformatted window 
as shown below: 


Seat 1000 cate CODE 2000 O02 O52 Dose aEne SEED ODE HERS SEES C860 Hare WEE ete OrED OOFe 


t Implicit H H 
Yess sues soe sone cress sous care sues ese ont ve one ces , Soft : 
i Explicit + Key 
Beene sas sess oon smn eo 8 H 
| Unformatted 3 H 


S000 90S Cree C280 Heed WEEE FOEP Bere SEE CRED BEES ORES CEES BhED Hote SH Soe COED BHTe 


Each window is controlled by a different subtask and has a 
different alternate character set Cif that option is specified) 
according to the following scheme: 


Window Type Character Set 


2000 CPOs B8ed Hove EES Ober EOE HeED FETE HENS BEES SOE AEE DOLD SHEE OOP SEER EOE HOUT GoET CORE CHES SOUS tee Eber HOD OwEt BeLe COL OUTS ERE FOEE Sere rEH0 


I Std. 
E. Alt4 
U Alte 
S ALt3 
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If any one of the alternate character sets is not specified in 
the AL.TCHARSET parameter, then the Standard (Std.) character set 


will be used instead. 


The Explicit Window also has eight protected fields. 
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6.4 Non-menu Terminal Exerciser Function Task: TASK4 H 
TASK4 performs output and device control tests on any non-meny > 
2640B, 26440, 2645A, 264B8A, 2647A, 2649A, or 2621A terminal 
attached to the HP 300, In the case of the 2645A terminal, 10 H 
tests using the cartridge tapes can optionally be performed, 
TASK 4 (DEVICE NAME ,TAPE , AL TCHARSET] 
Parameters! 
DEVICE _NAME Specifies the name associated with the 
terminal. Default is "TERMi". H 
> 
TAPE (Only for terminals with tape cartridges) H 
i 
QO==> No tape cartridge drives tested (default) i 
i==> Left tape cartridge tested H 
2==> Right tape cartridge tested H 
> 
AL TCHARSET (Same as for TASKS) H 
> 


The terminal exerciser performs a test similar to that performed 
by the printer exerciser: A block of asterisks are printed 
followed by a block of all printable characters. When alternate 
character sets are indicated in the ALTCHARSET parameter, one 
test is performed for ench specified alternate character set. 


After the printing tests, the tape tests are performed (when 
requested via the TAPE parameter), The one tape drive test’ 
performs the following: 


(1) the LEFT tape is rewound, (2) ten records are written onto 
the LEFT, (3) the LEFT tape is rewound, (4) the ten records are 


read off of the LEFT tape and checked for errors, (3S) the LEFT 
tape is rewound. 


The two tape drive test performs the following: 


(1) the LEFT and RIGHT tapes are rewound, (2) ten records are 
written onto the LEFT tape, (3) the LEFT tape is rewound, (4) the 
ten records are copied from the LEFT to its RIGHT tape, (5) both 
tapes are rewound, (6) the ten records are read from the right 
tape and checked for errors, (7) the RIGHT tape is rewound, 
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7.0 STANDARD SCRIPTS 


There are two standard scripts that are shipped with the 
WORKOUTSO0 program: SCRIPTi, corresponding to a minimal 
configuration, and SCRIPT2, which exercises a larger 
configuration. 


Due to the flexible nature of system configurability, these 
scripts are necessarily skeletal in form: some work must be done 
to the scripts and to the environment that WORKOUT3S00 will see. 


Concerning the scripts, volume names and device names in the 
script need to be changed to correspond to actual names. These 
actual names can be obtained from the system build listing and/or 
by issuing one or both of the following AMIGO environment 
commands: 


SHOW STATUS OF ALL VOLUMES 
SHOW STATUS OF ALL DEVICES. 


Furthermore, task identifiers in the script that correspond to 
system functions exercising non-existent devices should be 


deleted from the script. 


All such modifications to the script can be accomplished in the 
WORKOUT300 Environment without having to resort to TYPIST. 


TYPIST needs to be used only when additional lines need to be 
added to a script. 


Concerning the environment, WORKOUTS00 expects certain domains 
and volumes to exist for all dise exercising functions. These 
domains must either be created on their respective device/volume 
or the domain name in the identifer declarations in the script 
must be changed to an existing domain name on that device/volume, 
Similarly, volumes with the appropriate labels must be supplied 
or created, or the volume names must be altered in the script. 
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7.4 SCRIPTL (Quick and Dirty -- 20 min.) 


This script is found in SCRIPT on the WORKOUTSOO Diskette. It 
exercises the following: 


(4) The System disc (domain SCRATCH) 
(2) The line printer (Name PRINTER) 


(3) The IDS (device name CONSOLE) 


i oe eS et tal 


The script is relatively short and should take fifteen to twenty 
minutes to complete. It is listed below: 


Ti0:= TASKILI 
i= TASK2CPRINTER] 

T30:= TASKSCCONSOLE I 
COLLECTION 

TiO 

Ti0,T1i0 
COLLECTION 

T20,T390 

T30 


om ee we me 


If the printer is run spooled, the script will complete 
faster, but the printer will continue to print after WORKOUT300 
is finished, If the printer is a 2608, the script will also run 
more quickly. To delete testing of the printer, use the cursor 
control and delete character keys to delete T20 from the second 
collection before hitting the START WORKOUT softkey. If the names 
of the printer or console have been changed, they can be edited 
before hitting the START WORKOUT softkey. 


RO me a ml OO ee OO ee ee 
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Note that since the flexible dise is a private volume, a 
private domain must be first created by the operator, and then it 
must be specified in the Declaration Block. If different names 
other than PRINTER, CONSOLE, or TERML are assigned to the 
devices, the script will have to be edited. This script could be 
modified to test other private volumes (i.e. a 7925) by simply 
specifying a different volume-name in place of DSTEST. 

~hp- 


> 

7.2 GCRIPT2 ~- More extensive H 
This script is found in SCRIPT2 on the WORKOUT300 diskette, and H 
adds a test of the flexdisc and a single non-menu mode terminal H 
(device mame TERMi> to the script SCRIPTL. To run this script, H 
it if necessary to first prepare a formatted floppy as follows: H 
i 

CREATE LABEL TEST ON DEVICE FLEXDISC H 
i 

followed by H 
i 

CREATE DOMAIN TEST7902 ON VOL DSTEST H 
CREATE DOMAIN TESU7902 ON VOL. DSTEST t 
The script is listed below: H 
T10:=TASKICI H 

TAL: =TASKLLTEST7902, ,DSTESTI H 
Ti2:=TASKLITESU7902 , ,DSTESTI H 
T20:=TASK2LTPRINTER] i 
T30:=TASK 3CCONSOLE] ; 
T40:=TASK4[E TERM1L] H 
COLLECTION H 
Tid i 
T1i0,T1i0 H 
COLLECTION H 
T20,T30 H 

T30 H 
COLLECTION \ 
T40 ' 

T40 1 

T40 H 
COLLECTION i 
Ti4i,Ti2 i 

H 

H 

H 

> 
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